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PREFACE 


This  user’s  manual  describes  the  use  of  a  data  base  system  for  geo¬ 
technical  construction  control  of  earth  and  rock-fill  dam  embankments. 

The  system  is  a  product  of  the  Computer  Applications  in  Geotechnical 
Engineering  (CAGE)  Project  of  the  Office,  Chief  of  Engineers,  U.  S.  Army. 

Mr.  David  P.  Hammer,  Soil  Mechanics  Division  (SMD),  Geotechnical 
Laboratory  (GL),  U.  S.  Army  Engineer  Waterways  Experiment  Station  (WES) 
(now  with  the  Ohio  River  Division)  provided  overall  direction  in  devel¬ 
oping  the  system  and  led  the  system  development  team.  The  data  base 
design  and  software  were  developed  jointly  by  Mr.  Earl  V.  Edris,  Jr., 

SMD,  GL,  WES,  project  engineer  for  the  system  and  Dr.  Darrell  L.  Ward, 
Computer  Science  Department,  North  Texas  State  University.  The  initial 
application  of  the  system  was  sponsored  by  the  San  Francisco  District  on 
Warm  Springs  Dam,  Calif.,  and  personnel  of  that  project  office  provided 
user  application  needs  and  developed  report-writing  programs  for  the 
system.  Another  application  that  resulted  in  generalizing  of  some  soft¬ 
ware  was  sponsored  by  the  Savannah  District  on  Richard  B.  Russell  Dam, 

Ga.  Mr.  Edris  prepared  the  report.  The  introduction  was  furnished  by 
Mr.  Hammer.  Mrs.  Wipawi  Vanadit-Ellis  made  several  additions  and  revi¬ 
sions  and  completed  the  Appendices.  Mr.  Hammer  was  the  CAGE  Project 
Investigator  until  November  1980,  when  Mr.  William  E.  Strohm,  Jr.,  Engi¬ 
neering  Geology  and  Rock  Mechanics  Division  (EGRMD) ,  GL,  WES,  became 
Project  Investigator.  Mr.  Jack  Pickett  (DAEN-CWE-BA)  provided  valuable 
review  comments. 

Criteria  for  the  Geotechnical  Construction  Control  Data  System  was 
developed  by  the  CAGE  Quality  Assurance  (QA)  Task  Group  composed  of 
Messrs.  Hammer  and  Edris  with  assistance  from  personnel  of  the  South 
Pacific  Division,  San  Francisco  District,  and  Warm  Springs  Dam  Project 
Office,  Savannah  District  and  Richard  B.  Russell  Dam  Project  Office. 

Since  November  1980,  CAGE  project  work  has  been  directed  by  a 
Management  Group  composed  of  the  following:  Mr.  Paul  Fisher,  Chief, 
Geology  Section,  Geotechnical  Branch  (GTB),  OCE  (DAEN-CWE-SG) ,  Chairman; 
Mr.  Richard  Davidson,  Chief,  Soil  Mechanics  Section,  GTB,  OCE 


(DAEN-CWE-SS) ;  Mr.  Richard  Malm,  Chief,  Computation  and  Analysis 
Section,  General  Engineering  Branch,  OCE  (DAEN-CWE-BA) ;  Mr.  Samuel 
Gillespie,  Engineer,  Civil  and  Environmental  Engineering  Branch,  OCE 
(DAEN-MPE-D) ;  Mr.  Leroy  McAnear,  Chief,  SMD,  WES  Program  Manager,  CW  R&P 
Program,  Materials  -  Soils;  Dr.  Don  Banks,  Chief,  EGRMD,  WES  Program 
Manager,  CW  R&D  Program,  Materials  -  Rock;  Mr.  William  E.  Strohm,  Jr., 
Principal  Investigator,  CAGE.  This  investigation  was  carried  out  under 
the  general  supervision  of  Dr.  William  F.  Marcuson  III,  Chief,  Geotech¬ 
nical  Laboratory. 

Commanders  and  Directors  of  WES  during  development  of  this  data 
system  and  publication  of  this  user's  manual  were  COL  Nelson  P.  Conover, 
CE,  and  COL  Tilford  C.  Creel,  CE.  Technical  Director  of  WES  was 
Mr.  Fred  R.  Brown. 
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CONVERSION  FACTORS,  INCH- POUND  TO  METRIC  (SI) 
UNITS  OF  MEASUREMENT 


Inch-pound  units  of  measurement  used  in  this  manual  can  be  converted  to 
metric  (SI)  units  as  follows: 


_ Multiply _ 

cubic  yards 

feet 

inches 

miles  (U.  S.  statute) 
pounds  (force)  per  square  inch 
pounds  (mass)  per  cubic  foot 
square  inches 


_ & _ 

0.7645549 

0.3048 

2.54 

1.609347 

6.894757 

16.01846 

6.4516 


_ To  Obtain 

cubic  metres 
metres 
centimetres 
kilometres 
kilopa seals 
kilograms  per  cubic  metre 
square  centimetres 


GEOTECHNICAL  CONSTRUCTION  CONTROL  DATA  BASE  SYSTEM 

USER'S  MANUAL 


PART  I:  INTRODUCTION 


Purpose 

1.  This  report  is  intended  to  provide  a  description  of  and  in¬ 
structions  for  use  of  the  geotechnical  construction  control  data  base 
system  developed  by  the  Computer  Applications  in  Geotechnical  Engineer¬ 
ing  (CAGE)  project  for  and  in  conjunction  with  the  U.  S.  Army  Engineer 
District,  San  Francisco.  The  report  is  written  for  the  general  user  and 
is  not  intended  to  replace  the  computer  operating  system  and  data  base 
user's  manual. 


Basic  Definitions 


2.  A  data  base  can  be  defined  as  pieces  or  groups  of  data  stored 
together  in  an  orderly  form  such  that  access  to  all  or  any  part  of  the 
data  can  be  readily  accomplished.  Data  manually  stored  in  a  filing 
cabinet  could  be  classified  as  a  simple  form  of  a  data  base.  A  compu¬ 
terized  data  base  is  one  that  utilizes  a  computer  and  associated  hard¬ 
ware  for  data  entry,  storage,  and  access.  A  data  base  system  includes, 
in  addition  to  the  data  base  Itself,  all  peripheral  software  that  ena¬ 
bles  the  data  not  only  to  be  quickly  and  orderly  stored,  but  accessed  in 
any  form  desired  and  manipulated  or  analyzed  by  whatever  means  most  use¬ 
ful  to  the  user.  A  data  base  system  can  therefore  be  categorized  as  an 
engineering  tool.  It  can,  if  properly  utilized,  be  a  powerful  tool  that 
greatly  enhances  the  usefulness  and  value  of  the  data. 

3.  More  specifically,  an  earthwork  construction  control  data  base 
system  is  a  computerize'  system  t  provides  for  the  orderly  storage, 
retrieval,  and  analysis  oi  <■  jta  esulting  from  testing  performed  during 
construction  of  an  earth  and/or  rock-fill  embankment.  Since  the  purpose 


of  this  testing  is  to  monitor  the  quality  of  construction  and  provide 
as-built  documentation,  proper  use  of  the  data  base  system  described 
herein  can  allow  for  the  accomplishment  of  these  features  in  a  more 
effective  manner  than  heretofore  possible.  Also,  use  of  this  type  of 
data  base  system  can  also  be  very  helpful  in  several  phases  of  contract 
administration. 

Background 

4.  The  need  for  the  use  of  data  base  systems  in  geotechnical 
engineering  was  identified  by  Hammer  and  Bennett  (1979).  The  specific 
application  of  a  data  base  system  for  construction  control  data  was  also 
identified  but  not  as  the  highest  priority.  However,  the  application 
proceeded  ahead  of  some  higher  priority  items  when  a  request  for  devel¬ 
opment  of  such  an  application  for  use  during  construction  of  Warm 
Springs  Dam  was  made  to  the  WES  by  the  U.  S.  Army  Engineer  District,  San 
Francisco,  through  the  South  Pacific  Division  office. 

5.  Warm  Springs  Dam  is  an  approximately  300-ft*-high  zoned  earth- 
fill  dam  located  at  the  confluence  of  Warm  Springs  and  Dry  Creeks  about 
80  miles  north  of  San  Francisco,  Calif.  It  contains  in  excess  of 

30  million  cubic  yards  of  compacted  earth- rock  materials.  The  design 
called  for  an  average  of  95  percent  of  the  modified  compaction  effort 
(ASTM  D  1557-78,  Method  D)  (from  American  Society  for  Testing  and  Mate¬ 
rials  (ASTM)  1981)  to  be  obtained  within  a  specified  water  content  range 
of  1  percent  dry  to  2  percent  wet  of  optimum  water  content.  Placement 
rates  were  to  be  upwards  of  100,000  cubic  yards  of  compacted  material 
per  day  (two  shifts).  The  majority  of  materials  to  be  used  consisted  of 
clayey  gravels  and  gravelly  clays,  materials  that  are  excellent  from  the 
standpoint  of  engineering  properties  but  very  difficult  to  control  with 
respect  to  desired  percent  compaction  and  specified  water  content. 
Therefore,  a  large  volume  of  compaction  control  data  would  be  generated 


*  A  table  of  factors  for  converting  inch-pound  units  of  measurement  to 
metric  (SI)  units  is  presented  on  page  4. 


during  construction  and  time  was  of  the  essence  in  developing  the  data 
and  reporting  the  results. 

6.  Accordingly,  the  San  Francisco  District  with  encouragement  from 
the  South  Pacific  Division  entered  into  an  agreement  with  the  U.  S.  Army 
Engineer  Waterways  Experiment  Station  (WES)  under  the  CAGE  program  to 
develop  a  geotechnical  construction  control  data  base  system  for  use  at 
the  Warm  Springs  Project. 

7.  Work  on  the  data  base  was  initiated  in  December  1979  and  the 
system  was  up  and  running  by  the  spring  of  1980.  While  in  use  during 
the  1980  construction  season  the  system  was  further  debugged  and  was 
improved  considerably.  By  the  end  of  the  1980  season  the  system  was 
98  percent  stabilized  and  being  used  extensively. 


Applications 

8.  By  providing  virtually  instant  recall  and  analysis  capability 
with  output  in  any  desired  format,  the  system  can  be  useful  in  providing 
the  following  applications  during  project  construction: 

a_.  More  effective  daily  control  of  desired  percent  compaction 
and  specification  requirements  such  as  placement  water 
content  and  material  suitability. 

b^.  Constant  monitoring  of  the  construction  control  system  it¬ 
self  (i.e.,  monitoring  of  methods  used  in  determining  maxi¬ 
mum  dry  density  and  optimum  water  content,  rapid  water  con¬ 
tent  and  gradations,  rock  corrections,  field  test  locations 
and  frequency,  etc.). 

c_.  Generation  of  Eng  Form  4080,  "Summary  of  Field  Compaction 
Control  Data"  and  associated  forms. 

<i.  Providing  assistance  in  the  solution  of  problems  that 

develop  during  construction  relating  to  compactive  effort, 
density,  water  content,  and  material  type,  source,  and 
quantity. 

e_.  Providing  assistance  in  working  out  day-to-day  problems  and 
misunderstandings  with  the  contractor. 

£_.  Providing  the  designer  with  instant  access  to  the  latest 
data  whenever  the  need  arises. 


9.  In  addition  to  the  foregoing,  the  system  can  he  an  invaluable 
aid  and  labor-saving  device  during  preparation  of  the  Criteria  and  Per¬ 
formance  Report  and  in  defending  contractor  claims  during  and  subsequent 
to  project  construction.  The  system  can  also  be  of  service  to  the  anal¬ 
ysis  and  solution  of  certain  problems  that  may  develop  during  project 
operation. 


System  Requirements 

10.  In  order  to  use  this  data  base  system,  the  project  must  have  a 
means  of  accessing  the  programs  which  currently  (1983)  reside  on  the 
Boeing  Computer  Service  (BCS)  mainframe  computer  system.  All  U.  S.  Army 
Corps  of  Engineer  districts  have  access  to  this  computer  system  through 
the  Corps-wide  Teleprocessor  Services  Program  (TSP).  To  access  the  com¬ 
puter  service,  the  project  office  needs  to  have  use  of  a  time-sharing 
terminal  with  the  necessary  equipment  to  transmit  data  over  the  tele¬ 
phone  lines.  The  type  of  terminal  determines  the  amount  and  means  of 
entering,  retrieving,  and  displaying  data.  A  minimum  terminal  would  be 
one  with  the  capability  of  getting  a  hard  or  paper  copy.  Most  data  out¬ 
put  is  set  up  for  use  on  a  132-character  printer  which  is  the  minimum 
equipment  needed  for  the  various  graphic  programs.  However,  a  graphic 
terminal  would  enable  the  user  to  obtain  a  better  quality  of  graphic 
plots.  The  increasing  availability  and  low  cost  of  microcomputers  in¬ 
creases  the  possibilities  for  the  project  to  become  semi-independent 

of  the  large  computers.  Terminals  need  a  relatively  clean  (dust-free) 
environment,  which  could  be  a  problem  for  the  project  office. 

11.  The  number  of  people  trained  to  use  this  data  base  system  is 
determined  by  the  project  size  and  testing  frequency.  Cenerally,  one  or 
two  project  personnel  are  needed  to  enter  and  retrieve  data.  In  addi¬ 
tion,  there  needs  to  be  one  responsible  individual,  usually  the  embank¬ 
ment  engineer,  who  knows  what  to  do  with  the  data.  Training  project 
personnel  to  use  the  data  base  system,  usually  a  three-day  process,  is 
accomplished  by  CAGE  project  personnel  who  will  visit  the  project  site. 


12.  To  implement  the  geotechnical  construction  control  data  base, 
the  project  or  district  personnel  need  to  contact  the  CAGE  project  per¬ 
sonnel  at  WES.  A  meeting  will  be  arranged  to  discuss  details  of  the 
system  in  meeting  project  needs  (projects  have  different  types  of  data, 
operating  procedures,  and  objectives).  If  there  are  no  major  changes  or 
reprogramming,  the  CAGE  personnel  will  set  up  the  data  base,  other  asso¬ 
ciated  programming  similar  to  the  type  presented  in  this  report,  along 
with  training  at  very  little  cost  to  the  project  or  district. 

13.  The  project  cost  to  use  the  data  base  system  will  depend  upon 
usage  of  the  system,  how  much  data  is  entered,  and  how  much  the  project 
uses  the  system  for  data  retrieval.  The  costs  for  the  various  examples 
in  Parts  III  and  IV  are  shown  to  provide  an  indication  of  the  total 
operating  costs. 

Other  Applications 

14.  After  the  initial  system  was  developed  for  Warm  Springs  Dam, 
three  other  projects  contacted  CAGE  to  implement  a  data  base  system. 

The  variations  in  operating  procedure  and  programs  to  meet  these  project 
needs  are  included  in  Parts  III  and  IV.  The  first  additional  request 
was  made  by  Savannah  District  for  use  at  Richard  B.  Russell  Dam.  A  dif¬ 
ferent  data  entry  procedure  was  developed  (Example  3)  along  with  modify¬ 
ing  some  of  the  output  programs.  The  next  two  requests  were  from  the 

U.  S.  Army  Ehgineer  District,  Los  Angeles,  for  use  with  their  projects 
in  the  Phoenix,  Ariz.,  area  (Adobe  Dam  and  Skunk  Creek  project).  Adobe 
Dam  is  an  identical  duplicate  of  the  Warm  Springs  system,  while  the 
Skunk  Creek  system  contains  some  minor  data  element  changes. 

Report  Organization 


15.  The  remainder  of  this  report  is  broken  into  three  parts  or 
modules.  Part  II  describes  the  data  base  structure  and  lists  the  vari¬ 
ous  data  elements.  Part  III  explains  the  various  procedures  to  enter 
data  to  the  system.  Part  IV  describes  all  the  methods  to  obtain  data 


PART  II:  STORAGE  MODULE 


Data  Base  Structure 


16.  The  construction  control  data  base  management  system  uses 
System  2000  (trademark  of  Intel  Systems  Corporation)  as  the  storage 
device.  This  data  base  is  a  hierarchy  or  tree-type  of  system  where  data 
are  grouped  into  functional  units  at  each  level  and  each  level  has  a  di¬ 
rect  relationship  to  the  data  appearing  above  and  below  that  level. 

This  storage  system  was  chosen  because  it  closely  models  the  project 
record-keeping  system  and  because  it  was  available  to  all  CE  Districts. 

17.  The  project  embankment  engineer  is  required  to  submit  a  sum¬ 
mary  of  field  compaction  control  data  on  Eng  Form  4080  or  4081  to  the 
district  office  at  a  preset  time  interval.  Form  4080,  shown  in  Figure  1, 
is  used  for  all  materials  except  granular  material  that  requires  a  rela¬ 
tive  density  for  which  Form  4081  (as  shown  in  Figure  2)  is  used.  By 
looking  at  how  the  forms  are  organized,  the  user  can  begin  to  comprehend 
the  structure  of  the  system.  The  project  information  at  the  top  of  the 
form,  identified  as  level  1  in  Figures  1  and  2,  will  remain  unchanged 
throughout  the  project.  Different  zones  of  a  dam  may  not  be  Included  on 
the  same  report;  therefore  the  first  level  or  branch  for  the  project  is 
the  embankment  zones.  The  data  identified  as  level  2  in  Figures  1  and 

2,  located  on  the  left  side  of  the  second  line,  are  the  same  for  all 
reports  on  a  zone.  As  stated  earlier,  results  for  each  zone  must  be 
reported  to  the  districts  at  prearranged  intervals.  Thus  to  simplify 
the  record  keeping,  report  periods  are  set  up  to  correspond  to  these 
intervals.  For  Warm  Springs  Dam,  these  reports  are  required  weekly; 
whereas  at  Richard  B.  Russell  Dam  the  reports  are  submitted  monthly. 

Each  report  is  designed  to  allow  the  district  office  to  have  all  the 
information  necessary  to  evaluate  the  construction  process.  Therefore, 
the  information  identified  as  level  3  in  Figures  1  or  2,  the  right  end 
of  the  first  two  lines.  Includes  the  data  that  pertains  to  the  report 
and  can  be  changed  for  each  report  interval.  During  each  reporting 
period,  a  number  of  density  and  associated  tests  are  performed.  The 


data  necessary  to  complete  level  4  of  the  forms  in  Figures  1  or  2  are 
required  for  each  test.  Sometimes  the  project  will  include  some  notes 
that  pertain  to  one  or  several  test  results,  as  illustrated  in  Figure  1. 
These  notes,  referenced  in  the  comment  field,  are  associated  with  the 
report  on  which  they  occur.  Thus  both  test  results  and  notes  are  asso¬ 
ciated  with  a  report  interval. 

18.  A  schematic  of  the  basic  data  base  structure,  a  four-level 
system  modeled  after  Eng  Form  4080,  is  shown  in  Figure  3.  The  top  level 
is  the  project  information  about  the  dam.  The  first  branch  is  the  em¬ 
bankment  zone  information  which  contains  general  and  specification-type 
of  information  that  is  unique  to  the  particular  zone,  identified  as 
level  2  in  Figures  1  and  2.  For  each  embankment  zone  there  is  a  varying 
number  of  report  periods  or  intervals.  This  information,  shown  as 
level  3  in  Figures  1  and  2,  consists  of  dates  and  type  of  equipment. 

The  test  data  and  notes,  shown  as  level  4  in  Figures  1  and  2,  reside 
under  the  report  period. 

Definition  of  Data  Elements 

19.  Within  each  repeating  group  or  level  of  the  data  base,  there 
are  individual  data  elements  which  have  names,  abbreviations,  component 
numbers,  and  other  attributes  identifying  the  type  of  data  that  will  be 
retained.  These  other  attributes  of  the  data  elements  are  an  indication 
of  how  the  data  element  is  stored  and  used  within  the  system,  the  data 
type,  and  the  field  size.  Each  data  element  is  stored  within  the  data 
base  in  one  of  two  ways,  depending  on  how  the  element  will  be  used.  If 
the  data  element  is  not  to  be  used  to  define  specific  data  groups,  the 
element  is  designated  as  a  NON-KEY  element.  However,  if  the  data  will 
be  used  to  define  specific  groups  of  data  for  analysis,  the  element  is 
designated  as  a  KEY  element.  For  example,  the  command  "List  embankment 
zone,  comp-percent  where  test-type  equals  SV  (sand  volume),"  will  cause 
an  error  message  "illegal  use  of  a  non-key  element."  Test-type  is  a 
NON-KEY  element  and  should  never  be  used  as  a  specifier  in  a  WHERE 
clause.  "List  embankment  zone,  comp-percent  test-type  where  embankment 


zone  equals  core;"  is  correct  since  embankment  zone  is  a  KEY  element. 

All  the  data  elements  within  the  system  fall  within  one  of  the  following 
four  types:  NAME  consists  of  any  combination  of  letters  or  numbers  and 
will  be  treated  as  text  material;  DATE  consists  of  a  fixed  format  for 
month,  day,  and  year;  of  the  two  types  of  numeric  data,  DECIMAL  allows  a 
decimal  point,  whereas  INTEGER  does  not.  The  field  size  is  the  maximum 
number  of  characters  that  can  be  stored  for  a  particular  element.  The 
data  elements  and  their  attributes  that  are  used  for  the  system  are 
listed  in  Table  1.  A  schematic  of  the  data  base  structure  using  the 
component  numbers  from  Table  1  is  shown  in  Figure  4. 

20.  The  data  base  structure  can  be  modified  for  any  particular 
specification  required  by  other  projects.  Data  elements  can  be  added, 
deleted,  rephrased  or  regrouped  by  redefining  or  rearranging  the 
structure.  As  a  minimum,  the  elements  for  Eng  Form  4080  should  not  be 
removed  because  they  are  used  in  the  established  retrieval  programs. 

Data  elements  that  are  invariable  for  one  level  can  be  moved  up  to  the 
next  level.  As  long  as  the  component  number  and  element  name  are  not 
changed,  any  established  retrieval  program  will  work.  Any  changes  to 
the  data  elements  should  occur  when  the  data  base  is  being  built  because 
the  cost  increases  greatly  to  make  changes  after  the  data  base  is  com¬ 
pleted  and  in  use. 

21.  To  establish  a  new  data  base,  users  should  evaluate  their 
needs  so  that  all  necessary  data  elements  are  included  in  the  system. 
This  evaluation  should  include  studying  this  manual  and  establishing 
communication  with  the  appropriate  personnel  at  WES,  with  other  users, 
and  with  district  and  project  personnel.  Once  the  data  elements  are 
identified,  the  structure  for  a  new  data  base  can  be  set  up.  In  addi¬ 
tion  to  the  data  elements,  other  attributes  must  be  selected.  In  par¬ 
ticular,  the  KEY  or  NON-KEY  designation  should  be  well  thought  out 
because  once  the  element  is  declared  NON-KEY,  the  user  cannot  search  the 
data  or  select  data  groups  using  that  element  as  a  qualifier.  Later 
versions  of  System  2000  allow  expensive  NON-KEY  searches.  Data  ele¬ 
ments  can  be  added,  subtracted,  or  modified  at  an  additional  cost  once 
the  data  base  is  established.  Therefore  the  benefit  of  changing  the 
element  must  be  weighed  against  the  additional  cost. 
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PART  III:  DATA  INPUT  MODULE 


22.  There  are  three  procedures  available  to  the  user  for  entering 
data  to  the  data  base.  The  first  procedure  entails  using  a  data  entry 
program  that  interfaces  directly  with  the  data  base.  This  method  keeps 
the  data  base  on  line  the  entire  time  the  user  is  accessing  the  program. 
The  second  procedure  generates  a  data  file  which  is  loaded  to  the  data 
base  at  the  user's  convenience.  This  method  only  accesses  the  data  base 
when  the  data  file  is  being  loaded.  The  same  question-answer  type  for¬ 
mat  is  used  for  both  of  the  above  procedures.  The  third  procedure  con¬ 
sists  of  adding  data  directly  to  the  data  base  files  while  the  user  is 
working  on  line  with  the  data  base.  With  this  piocedure  the  data  base 
is  not  protected  against  unexpected  session  interruptions.  The  first 
procedure  is  about  three  times  more  expensive  to  use  than  the  second 
procedure  because  of  the  time  the  data  base  is  on  line.  The  expense  of 
the  last  procedure  depends  upon  how  long  the  user  has  the  data  base  on 
line.  In  addition  to  adding  data  to  the  data  base,  the  third  procedure 
will  also  explain  how  to  change  and  remove  data  within  the  data  base. 

All  of  the  above  procedures  are  described  in  this  part  of  the  report. 

Data  Entry  Program  -  Interface  with  Data  Base 

Description 

23.  The  data  entry  program  is  designed  to  collect  raw  data  and  in¬ 
sert  the  data  directly  into  the  data  base.  The  program  operates  on  a 
time-sharing  basis  in  a  conversational  mode.  The  user  is  prompted  for 
the  data  on  an  item  by  item  basis,  starting  at  the  embankment  zone  level 
of  the  data  base  and  proceeding  to  all  lower  levels  (reports,  tests,  and 
notes).  After  each  prompt,  the  computer  waits  for  a  carriage  return  be¬ 
fore  proceeding.  It  is  possible  to  enter  only  the  project  information 
for  the  initial  data  base  entry.  The  prompts  used  to  request  the  items 
are  contained  in  a  separate  driver  file  that  the  program  accesses  and 
are  shown  in  Table  2.  With  the  driver  file  separate  from  the  program, 
the  user  can  modify  the  prompts  by  editing  this  file.  This  procedure 


interfaces  with  the  data  base  as  the  user  enters  either  the  embankment 
zone,  report  number,  or  test  number  to  determine  whether  the  entered 
value  is  new  or  already  exists.  In  addition,  the  program  can  check  to 
ensure  that  the  user  does  not  enter  either  report  information  or  test 
information  to  completed  reports  or  tests.  When  the  user  ends  a  data 
entry  session  and  successfully  loads  the  data  to  the  data  base,  the  data 
is  available  immediately  for  retrievals. 

24.  The  data  entry  program  collects  the  data  in  logical  groups  as 
indicated  in  Table  2.  The  embankment  zone  and  report  period  data  each 
comprise  a  group.  The  test  data  are  broken  down  into  three  groups  be¬ 
cause  all  of  the  test  data  are  often  not  available  at  the  same  time. 

The  first  group  which  is  entered  immediately  after  the  test  is  complete 
contains  the  location  information,  field  results,  and  the  1-point  com¬ 
paction  results.  The  second  group  contains  the  5-point  compaction 
results.  The  third  group  contains  data  which  is  available  several  days 
after  the  initial  test  and  consists  of  classification,  Atterberg  limits, 
various  specific  gravities,  and  sieve  analysis.  A  schematic  diagram  for 
the  program  is  shown  in  Figure  5.  An  unlimited  number  of  tests,  reports 
and  embankment  zones  may  be  entered  in  one  session.  New  embankment 
zones  and  report  numbers  can  be  entered  at  any  time  by  completing  the 
new  zone  or  report  information.  Also,  the  user  can  enter  one  data  group 
or  any  combination  of  data  groups. 

25.  The  program  will  allow  the  user  to  edit  the  data  before  in¬ 
serting  in  the  data  base.  After  the  entire  data  group  or  eight  items 
have  been  entered,  they  will  be  automatically  listed  for  the  user  to 
check.  Any  changes  can  be  made  at  this  time  by  following  the  instruc¬ 
tions  that  are  printed  with  the  listed  data.  Once  the  user  agrees  that 
the  items  are  correct,  more  data  can  be  entered  and  those  items  that 
were  reviewed  are  entered  into  the  data  base.  Thus,  if  an  error  comes 
to  light  at  a  later  time,  the  user  can  still  change  the  value  by  fol¬ 
lowing  the  CHANGE  procedure  described  later  in  this  part. 

26.  The  data  entry  program  contains  some  editing  capabilities  in 
addition  to  allowing  the  user  to  change  the  input  values.  Besides  the 
prompts,  the  information  in  Table  3  is  contained  in  the  driver  file  that 


Table  2 

Prompts  for  Requested  Information 
in  Data  Entry  Program 


Project 

Information 


Embankment 

Zone 


* 


Report 

Period 


Test  Data 
Group  1 


PROJECT  NAME? (40  CHAR.  WAX ) 

PROJECT  RIUER?(40  CHAR.  NAX) 

PROJECT  COUNTY? (20  CHAR.  NAX ) 
PROJECT  STATE? (2  CHAR.  NAX) 

PROJECT  TOWN? (20  CHAR.  NAX) 

CONTRACT  NUMBER? (20  CHAR.  NAX) 
CONTRACTOR? (40  CHAR.  NAX) 

EMBANKMENT  ZONE (INPUT  END  TO  QUIT)? 
CONPACTION  PERCENT? 

TYPE  OF  TEST? (3  CHAR.  NAX) 

UL  UNIT? 

UR  UNIT? 

S  PERCENT  LESS  THAN  200? 

FIELD  NOLD  SIZE? 

REPORT  NUNBER( INPUT  A  0  TO  QUIT)? 
BEGINNING  DATE?  (NN/DD/VYYY) 

TYPE  EQUIPNENT?( IS  CHAR.  NAX) 

LOOSE  LIFT  THICKNESS? 

CONPACTED  LIFT  THICKNESS? 

NUNBER  OF  PASSES? 

LAB  CONPACTION  EFFORT? 

ENDING  DATE?  (NN/DD/YYYY) 

TEST  NUNBERC INPUT  A  0  TO  QUIT)? 
TEST  DATE?  (NN/DD/YVYY) 

QA  OR  QC  LAB?( 1  CHAR.  NAX) 

STATION? (6  CHAR.  NAX) 

OFFSET? 

ELEUATION? 

DEPTH  IN  INCHES? 

MATERIAL  SOURCE?(10  CHAR.  NAX) 

SOIL  CLASSIFICATI0N?C7  CHAR.  NAX) 
SOIL  COLOR? (4  CHAR.  NAX) 

NAXINUN  PARTICLE  SIZE? 

FIELD  UET  DENSITY? 

QUICK  FIELD  WATER  CONTENT? 

QUICK  FIELD  DRY  DENSITY? 

FINAL  FIELD  WATER  CONTENT? 

FINAL  FIELD  DRV  DENSITY? 


(Continued) 


Table  2  (Concluded) 


Test  Data 
Group  1 
Continued 


LABORATORY  HOLD  SIZE? 

QUICK  ONE-POINT  WATER  CONTENT? 

QUICK  ONE-POINT  DRV  DENSITY? 

QUICK  OPT I NUN  WATER  CONTENT? 

QUICK  NAXINUn  DRY  DENSITY? 

ONE-POINT  DRV  DENSITY? 

ONE-POINT  WATER  CONTENT? 

SECOND-POINT  DRY  DENSITY? 
SECOND-POINT  WATER  CONTENT? 

FOC  NAXINUN  DRV  DENSITY? 

FOC  OPTINUN  WATER  CONTENT? 

QUICK  X  GREATER  THAN  3/4'? 

STD  X  GREATER  THAN  3/4'? 

CORRECTED  FOC  NAXINUN  DRY  DENSITY? 
CORRECTED  FOC  OPTINUN  WATER  CONTENT? 
CONNENTS?( 30  CHAR.  NAX > 


Test  Data 
Group  2 


5-POINT  CURUE  NUNBER? ( 6  CHAR.  NAX) 
5-POINT  NAXINUN  DRV  DENSITY? 

S-POINT  OPTINUN  WATER  CONTENT? 

BULK  SPECIFIC  GRAUITV? 

ABSORPTION? 

CORRECTED  S-PT  NAXINUN  DRY  DENSITY? 
CORRECTED  S-PT  OPTINUN  WATER  CONTENT? 


Test  Data 
Group  3 


LIQUID  LINIT? 

PLASTICITY  INDEX? 

SPECIFIC  GRAUITV  OF  SOLIDS? 
APPARENT  SPECIFIC  GRAUITY? 
SPECIFIC  GRAUITV? 

X  PASSING  #200  SIEUE? 

X  PASSING  #100  SIEUE? 

X  PASSING  #40  SIEUE? 

X  PASSING  #16  SIEUE? 

X  PASSING  #10  SIEUE? 

X  PASSING  #8  SIEUE? 

X  PASSING  #4  SIEUE? 

X  PASSING  3/8"  SIEUE? 

X  PASSING  1/2'  SIEUE? 

X  PASSING  3/4'  SIEUE? 

X  PASSING  1"  SIEUE? 

X  PASSING  1  1/2'  SIEUE? 

X  PASSING  2'  SIEUE? 

X  PASSING  3'  SIEUE? 


the  data  entry  program  accesses.  The  first  column  indicates  the  type  of 
data  item.  The  following  chart  shows  the  numeric  definition  of  the  dif¬ 
ferent  data  types: 

Type  1  ...  Integer  number 

Type  2  ...  Decimal  number 

Type  3  ...  Character  name 

Type  4  ...  Date 

The  second  column  indicates  the  length  of  the  variable.  The  number  of 
10-letter  computer  words  is  shown  for  character  and  date  items,  while 
the  number  of  digits  is  shown  for  numeric  items.  The  next  two  columns 
contain  the  minimum  and  maximum  values  of  numeric  data  items.  If  both 
values  are  zero,  the  item  will  not  be  checked;  however,  if  one  value  is 
nonzero,  the  data  are  checked  to  ensure  that  the  input  value  is  within 
the  minimum-maximum  range.  If  the  entered  value  is  outside  the  range, 
the  program  will  print  the  following  message  and  will  prompt  the  user 
for  the  same  data  item  again:  (entered  value)  IS  NOT  WITHIN  THE  LIMITS: 
[(minimum,  maximum)].  The  ranges  should  be  set  up  when  the  system  is 
initiated;  however,  the  values  can  be  changed  when  needed.  The  last  two 
columns  in  the  file  are  the  position  of  the  data  item  in  the  data  base 
and  the  data  base  name  of  the  item.  Using  this  information,  the  program 
knows  the  type  of  data,  the  size,  and  a  range  for  numeric  values;  thus, 
any  large  errors  (wrong  data  type  or  shifts  in  the  decimal  point)  are 
caught  and  the  user  is  required  to  enter  corrected  values  before  the 
data  are  inserted  into  the  data  base. 

27.  There  are  some  cautions  the  user  needs  to  be  aware  of: 

a.  Data  should  always  be  entered  with  no  leading  blanks. 

_b.  If  a  test  is  in  the  data  base  and  the  same  test  number  is 

entered  again,  all  the  old  data  for  that  data  group  will 
be  lost.  However,  if  a  different  data  group  is  added,  the 
other  information  associated  with  that  test  will  not  be 
affected . 

£.  Once  the  end  date  is  entered  for  a  report,  that  report  is 
not  available  for  changing  or  adding  notes  or  test 

information.  The  end  date  is  the  way  that  other  users  and 

retrieval  programs  can  check  for  complete  reports. 

jl.  The  following  error  messages  are  generated  by  the  program 
as  a  result  of  its  internal  editing: 


Table  3 

Data  Element  Editing  Information 


Limits  Posi- 

Type  Length  Min.  Max.  tion  Name _ 

34  0.  0.  i  PRO J -NAME 

34  0.  0.  5  PROJ-RIVER 

32  0.  0 •  9  PROJ-COUNTV 

31  0.  0.  11  PROJ-STATE 

32  0.  0.  12  PROJ-TOUN 

32  0.  0.  14  CONTRACT-NO 

34  0.  0.  16  CONTRACTOR 

32  0.  0.  1  ENBANK-ZONE 

27  90.0  98.0  3  CONP-PERCENT 

31  0.  0.  4  TEST-TVPE 

1  2  -3.  0.  5  UL-LINIT 

1  2  0.  12.  6  UR-LINIT 

12  0.  0.  7  S-PLT200 

12  0.  0.  8  FNS 

13  0.  0.  9  REPORT-NO 

41  0.  0.  1  BEGIN-DATE 

3  2  0.  0.  3  EQUIP 

12  0.  0.  5  LLT 

12  0.  0.  6  CPfPT 

12  0.  0.  7  PASSES 

3  1  0.  0.  8  C-EFFORT 

41  0.  0.  2  END-DATE 

16  0.  0.  1  NO 

41  0.  0.  4  DATE-NADE 

3  1  0.  0.  5  LAB 

31  0.  0c  6  STA 

16  0.  0.  7  OFT 

2  6  0.  0.  8  ELE 

12  0.  0.  9  DEP 

31  0.  0.  10  NS 

31  0.  0.  33  USCG 

31  0.  0.  32  CLR 

2  6  0.  0.  34  HPS 

26  0.  0.  11  FUD 

25  2.  14.  15  QFUC 

26  0.  0.  14  QFDD 

25  0.  0.  13  FUC 

26  0.  0.  12  FDD 

12  0.  0.  16  LNS 


(Continued) 


Table  3  (Concluded) 


Limits  Posi- 

Type  Length  Min.  Max,  tion  _ Name 

25  6.  0.  20  Q1UC 

26  0.  0.  19  Q1DD 

25  0.  0.  58  QOUC 

2  6  0.  0.  5?  QfIDD 

26  0.  0.  1?  DD1 

25  0.  0.  18  UC1 

26  0.  0.  81  DD2 

25  0.  0.  82  UC2 

26  0.  0.  24  RDD1 

25  0.  0.  25  0UC1 

12  0.  0.  27  QRCP 

12  0.  0.  26  RCP 

26  0.  0.  59  CHDD1 

25  0.  0.  60  COUC1 

3  3  0.  0.  54  COnilENTS 

31  0.  0*  63  CNO 

26  0.  0.  64  RDD5 

25  0.  0.  65  OUCS 

85  0.  0.  52  GR 

23  0.  0.  66  AB 

26  0.  0.  67  CRDD5 

25  0.  0.  68  C0UC5 

31  0.  0.  33  USCG 

1  3  0.  0*  48  LL 

12  0.  0.  49  PI 

25  0.  0.  50  GS 

25  0.  0.  51  GA 

25  0.  0.  53  G 

13  0.  0.  47  GR200 

13  0.  0.  46  GR100 

13  0.  0.  45  GR40 

13  0.  0.  44  GR16 

13  0.  0.  43  GR10 

13  0.  0.  72  GR8 

13  0.  0.  42  GR4 

13  0*  0.  41  GR375I 

13  0.  0.  40  GR5I 

13  0.  0.  39  GR75I 

13  0.  0.  38  GR1I 

13  0.  0.  37  GR15I 

13  0.  0*  36  GR2I 

13  0.  0*  35  GR3I 


OOPS!  NOT  A  VALID  INTEGER,  TRY  AGAIN 
OOPS!  NOT  A  VALID  REAL,  TRY  AGAIN 
OOPS!  NOT  A  VALID  DATE,  TRY  AGAIN 

However,  if  the  following  error  message  is  generated  when 
the  program  loads  the  data  to  the  data  base,  the  user 
needs  to  contact  the  system  administrator  to  determine 
where  the  error  is: 

WRAP  UP  CALLED  BY  ROUTINE,  'ROUTINE  NAME,'  AFTER 
THE  DATA  BASE  OPERATION  OF,  'DATA  BASE  OPERATION,' 
WITH  A  RETURN  CODE  OF,  'RETURN  CODE' 

All  the  data  is  printed  back  to  the  user  for  editing 
except  for  the  embankment  zone,  report  number,  and  test 
number.  If  one  of  these  values  is  entered  incorrectly, 
the  only  way  to  change  the  value  is  to  return  to  that 
level  of  the  program  by  indicating  that  the  user  is  not 
ready  to  enter  more  data  to  the  incorrect  embankment  zone, 
report  number,  or  test  number.  For  example,  if  report 
number  6  was  entered  but  report  number  5  was  intended  and 
report  number  6  did  not  exist,  the  program  will  indicate  a 
new  report  and  ask  if  you  were  ready  to  enter  the  new 
report  data,  the  user  would  Indicate  'NO.'  The  program 
would  then  ask  for  the  next  report  number,  now  the  user 
would  enter  the  report  number  5.  If  report  number  6 
existed  when  it  was  entered  erroneously,  the  user  would 
enter  0  for  both  the  test  number  and  group  number  to 
return  to  the  report  level.  The  same  procedure  would  be 
used  for  errors  in  the  embankment  zone  and  test  number. 
These  corrections  are  illustrated  in  the  next  section 
(Example  3) . 

28.  The  program  automatically  generates  the  percent  compaction, 
percent  saturation,  and  the  deviation  from  optimum  water  content  using 
the  following  equations: 


PCI  -  (FDD/CMDD1)  X  100 

-  (FIELD  DRY  DENSITY /MAXIMUM  DRY  DENSITY  FROM 
1-POINT  TEST)  X  100 

PC 5  -  (FDD/CMDD5)  X  100 

PSAT  «  FDD  X  FWC  X  G/(G  X  62.4)  -  FDD  (WARNING  MESSACE 
IF  VALUE  GREATER  THAN  100.5  PERCENT) 


-  FIELD  WATER  CONTENT  -  OPTIMUM  WATER  CONTENT 

FROM  1-POINT  TEST 

DOWC5  -  FWC  -  COWC5 

The  data  names  are  defined  in  Table  1.  When  only  a  1-point  test  is  run, 
the  maximum  dry  density,  optimum  water  content,  percent  compaction,  and 
deviation  from  optimum  water  content  of  record  are  based  on  this  test. 
However,  when  both  a  1-point  and  5-point  test  are  run,  the  results  of 
record  are  obtained  from  the  5-point  test.  The  following  tabulation 
using  the  abbreviated  data  element  names  defined  in  Table  1  illustrates 
this  concept : 


Data  for 

Data  for 

Element 

only  1-pt 

both  1-pt 

name 

test 

and  5-pt  test 

CT 

1 

5 

FMDD 

CMDD1 

CMDD5 

FOWC 

CCWC1 

C0WC5 

DOWC 

D0WC1 

D0WC5 

PC 

PCI 

PC  5 

29.  As  previously  mentioned,  the  data  entry  system  works  inter¬ 
actively  with  the  data  base.  The  following  commands  are  required  to  use 
this  procedure: 

GET,  INPXXX 
CALL,  INPXXX 

where  XXX  identifies  the  project  (e.g..  Warm  Springs  Dam  *  WSD) .  The 
examples  in  the  next  section  illustrate  this  procedure.  Because  of  the 
high  cost  of  working  on  line  with  the  data  base,  modifications  were  made 
to  this  program  to  develop  a  data  file  entry  procedure  which  will  be 
described  in  the  next  section. 


30.  Example  1.  This  example,  shown  in  Table  4,  illustrates  the 
data  entry  program  operation  for  a  new  embankment  zone,  report  number, 
and  for  all  three  data  groups  of  a  new  test  number.  Throughout  the 
example  the  data  correction  and  the  program  editing  capabilities  are 
shown.  The  cost  to  enter  this  example  will  vary  according  to  the  size 
of  the  existing  data  base.  For  a  small  data  base,  the  cost  was  about 
twelve  dollars. 


Table  4 


Data  Entry  Procedures  During  Interface  with  Data  Base  (Example  1) 


(Continued) 


Table  4  (Continued) 


1.. . REPORT  NUNIERC INPUT  A  9  TO  QUIT)? 

I>1 

1  IS  A  NEW  REPORTING  PERIOD 

ARE  VOU  READV  TO  INPUT  NEU  VALUES?  (V  OR  N) 

I>V  „  ,  ,  ,, 

1.. . BEGINNING  DATE”?  (NN/DD/YY YY>  StdAt  R fpOKt  V&U.od  Data. 

I>02/24/1981 

2.. . TYPE  EOUIPNENT?( 15  CHAR.  NAX) 

I>SHEEPFOOT  ROL 

3.. . LOOSE  LIFT  THICKNESS? 

I>fi 

4.. .C0NPACTED  LIFT  THICKNESS? 

I>4 

5.. .NUNBER  OF  PASSES? 

I6^..LAB  COflPACTION  EFFORT?  Ent&ltd  UVLOnQ 

i>std  AJi^onmation 


REVIEW  OF  INPUT 

LINE  *  DATA  VALUE 

1  .  02/24/1981 

2  .  SHEEPFOOT  ROL 

3  . 6 

4  .  4 

i  !!!!”!!  Itd  Wnong 

TO  CHANGE  AN  I TEN,  TYPE  ITS  LINE  * 

OTHERWISE  HIT  RETURN 

I>6  Lajic.  ^6 

6... LAB  CONPACTION  EFFORT?  °  . 

i>nod  coftAectea 

TO  CHANGE  AN  ITEC1,  TYPE  ITS  LINE  * 

OTHERWISE  HIT  RETURN 

I> 

DO  VOU  WISH  TO  REVIEW  VALUES  AGAIN?  (V  OR  N) 


REVIEW  OF  INPUT 

LINE  *  DATA  VALUE 

1  .  02/24/1981 

2  . SHEEPFOOT  ROL 

3  . 6 

4  . 4 

5  ........  S 

6  NOD  CoHAZCXzd 


TO  CHANGE  AN  I TEN,  TYPE  ITS  LINE  • 
OTHERWISE  HIT  RETURN 
I> 


End  of  azpoat  p zxiod  data 


(Continued) 
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Table  4  (Continued) 


1...TEST  NUMBER < INPUT  A  0  TO  OUIT>? 

010001 


10001  IS  A  NEU  TEST 


ARE  VOU  READV  TO  INPUT  NEU  UALUES?  <Y  OR  N> 

I>Y 

INPUT  THE  TEST  CROUP  <1,2  OR  3) 

input  a  zero  to  ouit  StaAt  teJst  data  gAoup  7 

1.. .  TEST  DATE"?  <MM/DD/VYYY) 

O0 2/22/1981 

2.. .QA  OR  QC  LAB? ( 1  CHAR.  MAX) 

I>A 

3.. . 5.ATION? <6  CHAR.  MAX) 

O2S+O0 

I>i^0?F,rSET,  Attempted  to  znteA 

OOPS!  NOT  A  UAL  10  INTEGER,  TRY  AGAIN  a  fiejOtJL  VCbtlML  tn&tead 


4. .  .0.FSET? 

0120 

5.. .ELEUATI0N? 

0345. 8 

5.. . DEPTH  IN  INCHES? 
06 


7.. . MATERIAL  SOURCE? <10  CHAR.  MAX) 
OBORROU  I 

8.. . 501L  CLASSIFICATION? (7  CHAR.  MAX) 
OML-CL 


0)(  an  tntegoA 


REUIEU  OF  INPUT 


LINE  #  DATA  UALUE 

1  .  02/22/1981 

2  . A 

3  . 25+00 

4  .  120 

5  .  345.8 

6  . 6 

7  .  BORROU  I 

8  . ML-CL 


TO  CHANGE  AN  ITEM,  TYPE  ITS  LINE  • 
OTHERWISE  HIT  RETURN 
O 


(Continued) 
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Table  4  (Continued) 


1. .  .501.  COLOR? (4  CHAR.  RAX) 
DRBR 

2.. .nAxinun  particle  size? 

I>i.7S 

3.. . FIELD  UET  DENSITY? 
DH134.0 

4. .  .QUICK  FIELD  WATER  CONTENT? 

ma.a 

5.. . QUICK  FIELD  DRY  DENSITY’ 
D12S.1 

6.. . FINAL  FIELD  WATER  CONTENT’ 
I>11. 9 

?... FINAL  FIELD  DRY  DENSITY? 
D124.5 

8..  .LABORATORY  MOLD  SIZE’ 

I>G 


REVIEW  OF  INPUT 


LINE  t  DATA  VALUE 

1  .  RBR 

2  .  1.75 

3  .  134.0 

4  .  12.2 

5  .  125.1 

6  .  11.9 

7  .  124.5 

8  .  6 


TO  CHANGE  AN  I TEN,  TYPE  ITS  LINE  * 
OTHERWISE  HIT  RETURN 
I> 

1.. . QUICK  ONE-POINT  WATER  CONTENT’ 
I> 126.0 

2.. . QUICK  ONE-POINT  DRY  DENSITY’ 
D126.0 

3.. . QUICK  OPT  I  fill il  WATER  CONTENT’ 

Dll  .4 

4.. . QUICK  nAXINUn  DRY  DENSITY’ 
D127.0 

5.. . 0NE -POINT  DRY  DENSITY? 

D125.5 

6.. . 0NE-POINT  WATER  CONTENT’ 

I>9.9 

7. .  .5ECOND-POINT  DRY  DENSITY? 

I> 

8.. . 5ECOND-POINT  WATER  CONTENT’ 

D 


En tened  mong 
vaZue 


1 6  theAe  aAe  no  data  to  be 
enteAed,  uieA 
muit  hit  caAAiage  AetuAn 
to  continue. 


(Continued) 
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Table  4  (Continued) 


1.. .foc  naxinun  dry  density? 

I>  126.5 

2.. .F0C  OPTINUN  UATER  CONTENT'* 

Dll.  8 

3.. . QUICK  %  GREATER  THAN  3/4*? 

I>6 

4.. . 5.D  X  GREATER  THAN  3/4*? 

I>8 

5.. . CORRECTED  FOC  MAX I NUN  DRY  DENSITY? 
1)126.5 

6.. . CORRECTED  FOC  OPTINUN  UATER  CONTENT? 

du.g 

7 . .  . CONNENTS? ( 30  CHAR.  NAX> 

I)NG 


REUIEU  OF  INPUT 

LINE  *  DATA  UALUE 

1  .  126.5 

2  .  11.  e 

3  . 6 

4  . 8 

5  .  126.5 

6  .  11. 8 

7 . NG 

TO  CHANGE  AN  ITEN.  TYPE  ITS  LINE  • 
OTHERWISE  HIT  RETURN 
I) 


End  0((  tut  data,  gaoup  1 


INPUT  THE  TEST  GROUP  <1.2  OR  3) 

INPUT  A  ZERO  TO  QUIT  btOAA 

1)2 

1.. . 5.POINT  CURVE  NUNBER7C6  CHAR.  RAX) 
DR-722 

2.. . 5.POINT  NAXINUN  DRY  DENSITY? 

I) 132.5 

3.. . 5.POINT  OPTINUN  UATER  CONTENT? 

D8.5 

4 . .  . BULK  SPECIFIC  GRAVITY? 

D2.78 

5.. . ABSORPTION? 

D2.1 

6.. . CORRECTED  5-PT  NAXINUN  DRY  DENSITY? 
1)132*5 

7.. . CORRECTED  5-PT  OPTINUN  UATER  CONTENT? 
D8.5 


Stafit  tut  data  gfioup  1 


REUIEU  of  input 

LINE  •  DATA  UALUE 

1  . R-722 

2  .  132.5 

3  . 8.5 

4  . 2.78 

5  . 2.1 

6  .  132.5 

7  .  8.5 


TO  CHANGE  AN  ITEN,  TYPE  ITS  LINE  X  f„rl  ni.  text  data  nJinmn  7 
OTHERWISE  HIT  RETURN  tm  ZUZ  aaZa  9*-ouP  L 


OTHERUISE  HIT  RETURN 
I> 


(Continued) 
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Table  4  (Continued) 


INPUT  THE  TEST  GROUP  (1.2  OR  3) 

INPUT  A  ZERO  TO  QUIT 

I>3 

1. .  .SOIL  CLASSIFICATIONS?  CHAR. 
I>NL-CL 

3. .  .LIQUID  UNIT? 

I  >34 

3.. . PLASTICITY  INDEX? 

I>18 

4.. . 5.ECIFIC  GRAVITY  OF  SOLIDS? 

I>2.68 

5.. . APPARENT  SPECIFIC  GRAVITY? 
I>2.69 

6.. . 5.ECIFIC  GRAVITY? 
i>2.?e 

7.. .X  PASSING  #200  SIEVE? 

I>22 

8.. .x  passing  #iee  SIEVE? 

I>30 

REVIEW  OF  INPUT 

LINE  #  DATA  VALUE 

1  . NL-CL 

3 . 34 

3  .  18 

4  . 2.68 

5  . 2.69 

6  . 2.70 

7  . 22 

8  .  30 

TO  CHANGE  AN  I TEN,  TYPE  ITS  LINE  « 
OTHERWISE  HIT  RETURN 

I> 

1.. .X  PASSING  #40  SIEVE? 

1>33 

2.. .X  PASSING  #16  SIEVE? 

I>42 

3.. .X  PASSING  #10  SIEVE? 

I>49 

4.. .X  PASSING  #4  SIEVE? 

I>52 

5.. .X  PASSING  3/8*  SIEVE? 

I>60 

6.. .X  PASSING  1/2*  SIEVE? 

I  >65 

7.. .X  PASSING  3/4*  SIEVE? 

I>?0 

8.. .X  PASSING  1*  SIEVE? 

I> 


Staxt  tiAt  data.  Qtiomp  3 

RAX) 


(Continued) 


Table  4  (Concluded) 


REVIEW  or  INPUT 

LINE  *  DATA  VALUE 

1  .  33 

2  . 42 

3  . 49 

4  . 52 

5  . 60 

6  . 65 

7  . 76 

8  . 

TO  CHANGE  AN  ITEM,  TYPE  ITS  LINE  • 
OTHERWISE  HIT  RETURN 
I> 

1.. .X  PASSING  1  1/2’  SIEVE? 

I>95 

2.. .X  PASSING  2*  SIEVE? 

I>100 

3.. .X  PASSING  3*  SIEVE? 

I>100 

REVIEW  OF  INPUT 

LINE  t  DATA  VALUE 

1  . 95 

2  .  100 

3 .  100 

TO  CHANGE  AN  ITEN,  TYPE  ITS  LINE  0 
OTHERWISE  HIT  RETURN 
I> 

INPUT  THE  TEST  GROUP  (1.2  OR  3) 

INPUT  A  ZERO  TO  QUIT 

I>0 


End  o&  tzAt  data  gtioup  3 


IS  THIS  TEST  COMPLETE! Y  OR  N>? 

I>V 

IS  THIS  TEST  A  RETEST?  <Y  OR  N> 


1 . .  . TEST  NUH»ER< INPUT  A  0  TO  QUIT)?  ExaX  tZAt  Lz\>zZ 

I>0 

IS  THIS  REPORT  PERIOD  COMPLETED?  (YOON) 

I>N 

1.. . REPORT  NUMBER! INPUT  A  0  TO  QUIT)? 

1>z  Entzazd  u)Aong  fizpont 

2  IS  A  NEW  REPORTING  PERIOD  nwnbzA 

ARE  YOU  READY  TO  INPUT  NEW  VALUES?  (Y  OR  N) 

I>N 

1... REPORT  NUMER! INPUT  A  0  TO  QUIT)? 

I>0 

^...EMBANKMENT  ZONE!  INPUT  END  TO  QUIT)?  tQAmimUon 

DATABASE  CLOSED  AND  DATA  ENTRY  TERNINATED 


CC,OFF. 

C> 
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31.  Example  2.  This  example,  shown  in  Table  5,  illustrates  the 
data  entry  program  operation  for  an  existing  embankment  zone  and  report 
number,  and  data  groups  1  and  3  for  a  new  test  number.  This  example 
costs  about  eight  dollars  to  enter  to  a  small  data  base.  The  cost  will 
vary  according  to  the  size  of  the  data  base. 


Table  5 


Data  Entry  Procedure  for  Existing  Embankment 


Zone  and  Report  Number  (Example  2) 


OGET.INPUSD 
OCALl,  INPUSD 


DATA  ENTRY  SYSTEM  FOR  DAM  CONSTRUCTION 

1.. . EMBANKMENT  ZONE (INPUT  END  TO  QUIT)?  .  _ 

ORAN  DON  I  ExaJ>£A-W  ZOYIZ 

1.. . REPORT  NUMBER < INPUT  A  0  TO  OUIT)?  _  .  ^ .  .  .  . 

1)1  ExAJ>£tna  fi&pohX.  ■Lntzfwal 

I.# .TEST  NUMBER! INPUT  A  0  TO  QUIT)? 

010002 

10002  IS  A  NEU  TEST 

ARE  YOU  READY  TO  INPUT  NEU  UALUES?  (V  OR  N) 

I>Y 

INPUT  THE  TEST  GROUP  (1,3  OR  3) 

input  a  zero  to  ouit  staAt  teAt  data  gAoup  I 

1 . .  .TEST  DATE?  (MM/DD/YYYY) 

002/23/1981 

2.. .0.  OR  OC  LAB?( 1  CHAR.  MAX) 

I>C 

3.. . 5.ATION? (6  CHAR.  MAX) 

010*75 

4.. . 0.FSET* 

0-1010 

5.. .ELEUATI0N? 

0352.9 

6.. . DEPTH  IN  INCHES? 

06 

7.. . MATERIAL  SOURCE?! 10  CHAR.  MAX) 

OBOR  I 

8.. . 501.  CLASSIFICATION?! 7  CHAR.  MAX) 

OGC 

REUIEU  OF  INPUT 

LINE  *  DATA  UALUE 

1  .  02/23/1981 

2  . C 

3  .  10*75 

4  .  -1010 

5  .  3S2.9 

6  . 6 

7  .  BOR  I 

8  . GC 

TO  CHANGE  AN  ITEM,  TYPE  ITS  LINE  0 
OTHERWISE  HIT  RETURN 

O 


(Continued) 
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Table  5  (Continued) 


1.. .501.  C0L0R?<4  CHAR.  MX) 

I>DRRN 

2.. .NAXINUH  PARTICLE  SIZE? 

I>2.9 

3.. . FIELD  UET  DENSITY? 

IM39.9 

4. .  .  OUICIC  FIELD  WATER  CONTENT? 

IMS. 9 

5.. . QUICK  FIELD  DRY  DENSITY? 

IMS8.9  _ 

6.. . FINAL  FIELD  WATER  CONTENT?  Ent&LZd  MHOng 

I7^!final  field  dry  density?  value, 

IM27.0 

8.. . LABORATORY  NOLO  SIZE? 

I>6 

REUIEW  OF  INPUT 
LINE  8  DATA  UALUE 

1  . DRRN 

a .  2.9 

3  .  139.9 

4  .  IS. 9 

5  .  128.9 

6  .  IS.  wAona 

7  .  127.9 

8  . 6 

TO  CHANGE  AN  I TEN,  TYPE  ITS  LINE  t 
OTHERWISE  HIT  RETURN 

6.?. FINAL  FIELD  WATER  CONTENT?  Uwe  *6 

••  cofOie.ctzd 

TO  CHANGE  AN  ITEN,  TYPE  ITS  LINE  • 

OTHERWISE  HIT  RETURN 
I> 

DO  YOU  WISH  TO  REUIEW  VALUES  AGAIN7  (Y  OR  N) 


I>N 


(Continued) 
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1.. . QUICK  ONE-POINT  MATE*  CONTENT? 

I>8.6 

2.. . QUICK  ONE -POINT  DRY  DENSITY? 

I>126.9 

3.. . QUICK  OPT I NUN  WATER  CONTENT? 

I>9.6 

4.. . QUICK  HAXIHUN  DAY  DENSITY** 

I>131. 

5.. . 0.E-POINT  DAY  DENSITY? 

IM26.6 

6.. . 0.E-POINT  WATER  CONTENT? 

I>7.3 

?... SECOND-POINT  DAY  DENSITY? 

8.. . 5.COND-POINT  WATER  CONTENT? 

I> 

REVIEW  OP  INPUT 
LINE  *  DATA  VALUE 

1  . 8.0 

2  .  126.9 

3  . 9.6 

4  .  131. 

5  .  126.0 

6  . 7.3 

7  . 

8  . 

TO  CHANGE  AN  I TEN.  TYPE  ITS  LINE  0 
OTHERWISE  HIT  RETURN 
I> 

1.. .poc  HAXinun  dry  density? 

IM31.5 

2.. .F0C  OPT I NUN  WATER  CONTENT? 

I>9.0 

3.. . QUICK  X  GREATER  THAN  3/4*? 

me 

4.. . 5.D  X  GREATER  THAN  3/4'? 

IMS 

5.. . CORRECTED  FOC  HAXIHUH  DRY  DENSITY? 

IM32.6 

6.. . CORRECTED  FOC  OPT I NUN  WATER  CONTENT? 

I>8.7 

7. .  .C0NNENTS7O6  CHAR.  HAX) 

I>NG 

REVIEW  OF  INPUT 

LINE  •  DATA  VALUE 

1  .  131.5 

2  . 9.6 

3  .  16 

4  .  13 

5  .  132.6 

6  . ■.? 

7 . NQ 

TO  CHANGE  AN  I  TEN.  TYPE  ITS  UfC  6  Enrf  ^  ^  ^  g*oap  ; 


(Continued) 


(Sheet  3  of  6) 


Table  5  (Continued) 


INPUT  THE  TEST  GROUP  (1.2  OR  3) 

INPUT  A  ZERO  TO  OUIT 

!>• 

IS  THIS  TEST  COMPLETE ( V  OR  N>? 
I>N 

IS  THIS  TEST  A  RETEST?  (V  OR  N> 


I)Y 

INPUT  THE  RETEST  NUNBER 
TYPE  A  ZERO  TO  STOP 


1)10001 

1 . . . TEST  NUMBER! INPUT  A  0  TO  OUIT)’ 
I> 10603 


10003  IS  A  NEU  TEST 


Indicating  a 
Kctut  and.  it 6 
original  tut 
numbcA. 


Entered  i/Viong 
tut  numbu. 


ARE  YOU  READY  TO  INPUT  NEU  VALUES?  <Y  OR  N) 

I>N 

1 . .  . TEST  NUMBER! INPUT  A  0  TO  QUIT)? 

1)19002 

INPUT  THE  TEST  GROUP  (1,2  OR  3) 

INPUT  A  ZERO  TO  OUIT  .  .  ,  ,  . 

i>3  StaAt  tut  data  g Koup  3 

1. 4 .SOIL  CLASSIFICATION?!?  CHAR.  MAX) 

DGC 

2.. . LIQUID  LIMIT? 

1)21 

3.. . PLASTICITY  INDEX? 

1)10 

4.. . 5.ECIFIC  GRAUITY  OF  SOLIOS? 

1)2.74 

5.. . APPARENT  SPECIFIC  GRAUITY? 

I) 

6.. . 5.ECIFIC  GRAUITY? 

1)2.72 

7.. .K  PASSING  *200  SIEUE? 

I  >26 

8.. .X  PASSING  *100  SIEUE? 

1)30 

REUIEU  OF  INPUT 

LINE  «  DATA  VALUE 

1  . GC 

2  . 21 

3  .  10 

4  . 2.74 

5  . 

6  . 2.72 

? . 2S 

8 .  30 

TO  CHANGE  AN  ITEM,  TYPE  ITS  LINK  0 
OTHERWISE  HIT  RETURN 


(Continued) 
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Table  5  (Continued) 


1.. .8. PASSING  944  SIEVE? 

I>37 

2.. .X  PASSING  916  SIEVE? 

I>43 

3.. .X  PASSING  914  SIEVE? 

1)50 

4.. .X  PASSING  94  SIEVE? 

OSS 

5.. .*  PASSING  3/8*  SIEVE? 

I>64 

6.. .*  PASSING  1/2*  SIEVE? 

I> 

7.. .X  PASSING  3/4*  SIEVE? 

I>?S 

8.. . *  PASSING  1*  SIEVE? 

I>84 

REVIEW  OF  INPUT 

LINE  9  DATA  VALUE 

1  . 37 

2  . 43 

3  . 50 

4  . SS 

5  . 60 

6  . 

7  .  75 

8  . 80 

TO  CHANGE  AN  ITEN.  TVPE  ITS  LINE  9 
OTHERWISE  HIT  RETURN 
I> 

1.. .X  PASSING  1  1/2'  SIEVE’ 

1)90 

2.. . 1.  PASSING  2*  SIEVE? 

1)100 

3.. . 8. PASSING  3*  SIEVE? 

I) 

REVIEW  OF  INPUT 

LINE  9  DATA  VALUE 

1  . 90 

2  .  100 

3 . 

TO  CHANGE  AN  ITEM.  TVPE  ITS  LINE  8 
OTHERWISE  HIT  RETURN 
I) 


End  0(J  tut  data,  gtioup  3 


(Continued) 


Table  5  (Concluded) 


INPUT  THE  TEST  GROUP  (1,3  OR  3) 

INPUT  A  ZERO  TO  QUIT 

!>• 

IS  THIS  TEST  COMPLETE (V  Oft  N)? 
I>Y 

IS  THIS  TEST  A  RETEST?  (V  OR  N) 


I>N 

1...TEST  NUNS£R( INPUT  A  •  TO  QUIT)? 

meoei 

THIS  TEST  IS  COMPLETE,  SORRV 


1 . . .TEST  NUMBER (INPUT 
THIS  TEST  IS  COMPLETE. 


A  0  TO  QUIT)? 
SORRV 


Attempting  to 
e.ntet  data  to 
completed  tett 


1 . . . TEST  NUMBER( INPUT  A  0  TO  QUIT)? 

I >10003 

10003  IS  A  NEU  TEST 

ARE  VOU  READV  TO  INPUT  NEU  VALUES?  (Y  OR  N) 
I>N 

1...TEST  NUMBER( INPUT  A  0  TO  QUIT)? 

I>0 

IS  THIS  REPORT  PERIOD  COMPLETED?  (V  OR  N) 
I>V 

TYPE  THE  REPORT  END  DATE  (MM/DD/WW)? 


I> 02^28/ 1981 
ARE  THERE  ANY  NOTES  FOR  THIS  REPORT? (V  OR  N) 
I>N 

1... REPORT  NUMBER! INPUT  A  0  TO  QUIT)? 

I>1 


Entering  end-date 
to  fiepoAt  pentod 


HoteA 


1  IS  A  CLOSED  REPORT.  SORRY 

1.. . REPORT  NUMBER! INPUT  A  0  TO  QUIT)? 

I>0 

1.. . EMBANKMENT  ZONE (INPUT  END  TO  QUIT)? 
I>END 

DATABASE  CLOSED  AND  DATA  ENTRY  TERMINATED 


Attempting  to  enteA 
data  to  a  completed 
fiepont 


CC .OFF 


Description 

32.  This  data  entry  procedure  consists  of  two  programs.  The  first 
program  is  used  to  collect  the  new  data  and  build  a  data  file  which  is 
loaded  to  the  data  base  using  the  second  program.  As  in  the  first  pro¬ 
cedure,  the  data  collection  program  operates  on  a  time-sharing  basis  in 
a  conversational  mode.  The  prompting  for  the  data  on  an  item  by  item 
basis  and  all  the  editing  capabilities  described  previously  for  the 
first  procedure  operate  the  same  way  for  this  procedure.  The  data 
groups  and  the  external  driver  file  are  the  same  for  both  procedures. 

The  percent  compaction  and  deviation  from  optimum  water  content  are 
calculated  in  this  procedure  as  described  in  paragraph  28.  When  both 
1-point  and  5-point  tests  are  run,  the  results  of  the  5-point  test  are 
used  for  the  maximum  dry  density,  optimum  water  content,  percent  com¬ 
paction,  and  deviation  from  optimum  water  content  as  illustrated  in 
paragraph  28. 

33.  The  collection  program  does  not  interface  with  the  data  base; 
thus  it  cannot  determine  whether  an  embankment  zone,  report  number,  or 
test  number  is  new  or  existing  or  whether  the  data  for  a  report  period 
or  test  number  is  complete.  Therefore,  the  user  is  asked  whether  these 
levels  are  new  or  old.  If  only  a  portion  of  the  data  for  a  test  is 
available  for  entry,  the  collect  program  will  accept  the  information  but 
the  load  program  will  not  load  the  information  to  a  completed  report 
period  or  test  number.  The  advantage  of  this  procedure  is  the  cost 
savings.  With  the  first  procedure  the  two  examples  cost  about  twelve 
and  eight  dollars,  while  with  this  procedure  the  same  examples  cost 
about  four  and  a  half  and  four  dollars  to  enter  the  data  and  about 
seventy-five  cents  each  to  load  to  the  data  base. 

34.  There  are  some  cautions  for  this  procedure  the  user  needs  to 
be  aware  of : 


a^.  Data  should  always  be  entered  with  no  leading  blanks. 

b.  The  collection  program  does  not  check  for  test  information 
that  was  previously  entered.  However,  the  load  program 


will  generate  an  error  message  in  SUMFLE  (generated  during 
the  load  process)  and  not  load  duplicate  information  to 
the  data  base.  No  error  message  will  be  generated  nor 
data  loaded  when  the  report  period  or  test  has  previously 
been  indicated  as  complete. 

Once  the  end  date  is  entered  for  a  report,  that  report  is 
not  available  for  changing  or  adding  notes  or  test 
information.  If  the  data  need  to  be  changed,  the  user 
must  make  the  change  within  the  data  base  as  described  in 
the  next  section.  The  end  date  is  the  way  that  other 
users  and  retrieval  programs  can  check  for  complete 
reports . 

_d.  The  following  error  messages  are  generated  by  the  data 
collection  program  as  a  result  of  its  internal  editing: 

OOPS!  NOT  A  VALID  INTEGER,  TRY  AGAIN 

OOPS!  NOT  A  VALID  REAL,  TRY  AGAIN 

OOPS!  NOT  A  VALID  DATE,  TRY  AGAIN 

The  load  program  will  generate  the  following  error  message 
in  SUMFLE  if  the  data  cannot  be  loaded: 

WRAP  UP  CALLED  BY  ROUTINE  ’ROUTINE  NAME'  AFTER  THE 

DATA  BASE  OPERATION  OF  'DATA  BASE  OPERATION'  WITH 

A  RETURN  CODE  OF  'RETURN  CODE'  WITH  A  LEVEL  NUMBER 

OF  'LEVEL  NUMBER' 

If  this  occurs,  the  user  needs  to  contact  the  system 
administrator  to  determine  the  cause  of  the  error  and  how 
to  correct  the  data  file. 

e:.  All  the  data  is  printed  back  to  the  user  for  editing 

except  for  the  embankment  zone,  report  number,  and  test 
number.  If  either  the  embankment  zone  or  report  number  is 
entered  incorrectly,  the  only  way  to  change  the  value  is 
to  return  to  that  level  of  the  program  by  indicating  that 
the  embankment  zone  or  report  number  is  old  and  the  test 
number  is  zero.  For  the  report  period  the  user  will  have 
to  answer  additional  questions  concerning  the  completeness 
of  the  report  period.  If  the  test  number  is  incorrectly 
entered,  the  user  must  enter  a  zero  when  asked  to  select  a 
data  group.  >  additional  questions  must  be  answered 
negatively  before  the  program  will  ask  for  the  test  number 
again.  Examples  of  how  these  corrections  are  made  are 
shown  in  the  following  example  section. 

35.  The  following  two-step  process  is  involved  in  loading  data  to 
the  data  base  using  this  procedure: 
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_a.  A  data  file  is  created  by  using  the  data  collection  pro¬ 
gram  that  prompts  the  user  for  the  data.  This  program 
does  not  access  the  data  base.  The  commands  executing  the 
collection  program  are: 

GET,  INPXXX 

CALL,  INPXXX 

where  XXX  identifies  the  project.  This  program  creates  a 
data  file  called  DATXXX. 

_b.  The  data  file  (DATXXX)  is  loaded  to  the  data  base  using 
the  load  program  that  requires  no  input  from  the  user 
other  than  the  following  commands: 

GET,  UPDXXX 

CALL,  UPDXXX 

A  batch  load  program,  UPDXXXB,  is  recommended  for  a  large 
data  file.  Batch  loading  is  done  on  a  lower  priority  and 
will  reduce  the  cost  by  about  80  percent  compared  with 
interactive  loading.  The  only  other  difference  is  that 
the  batch  load  data  will  not  be  available  for  immediate 
retrieval.  During  the  load  process  a  file  called  SUMFLE 
is  created  indicating  the  embankment  zones,  report  number, 
test  numbers,  and  test  data  groups  that  are  loaded  into 
the  data  base.  If  any  problems  develop  during  the  load 
process,  the  error  message  will  be  located  in  this  file. 
Figure  6  shows  an  example  of  SUMFLE  with  no  errors,  while 
Figure  7  illustrates  the  file  when  an  error  has  occurred. 
This  error  must  be  corrected  in  the  data  file  DATXXX  as 
illustrated  in  Figure  8  before  the  user  attempts  to  load 
the  data  again.  (See  Appendix  D  for  use  of  CMEDIT  on 
BCS.)  After  the  data  is  successfully  loaded  to  the  data 
base,  the  data  file  created  in  the  first  step  must  be 
cleared  and  readied  for  more  data.  To  accomplish  this, 
the  following  commands  are  used: 

GET,  CLRXXX 

CALL,  CLRXXX 

Examples 

36.  Example  3.  This  example,  shown  in  Table  6,  illustrates  the 
data  file  entry  procedure.  The  data  used  in  this  example  are  the  same 
as  used  in  Example  1.  Throughout  the  example  the  data  correction  and 
program-editing  capabilities  are  shown.  The  cost  to  enter  this  example 
to  the  data  file  is  about  four  and  a  half  dollars.  An  additional 
seventy-five  cents  is  required  to  load  the  data  to  the  data  base.  Thus, 


a  total  cost  of  entering  this  example  is  five  and  a  quarter  dollars. 
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Figure  8.  Example  of  data  file  error  correction 


1 

Table  6 

Data  Entry  Procedure  for  a  New  Embankment  Zone 
Using  Data  File  Option  (Example  3) 


QET.IMPAB1 
OCALL,  1NPAB1 


DATA  ENTRY  SYSTEM  FOR  DAM  CONSTRUCTION 


1.. . EMBANKMENT  ZONE (INPUT  END  TO  QUIT)? 

I  >  RAN  DOM  I 

IS  THIS  A  NEU  ZONE?  (V  OR  N) 

I>Y 

1 . .  .COMPACTION  PERCENT? 

I>95.0 

2.. . TYPE  OF  TEST? (3  CHAR.  MAX) 

I>SU 

3.. .UL  LIMIT? 

I>-12 

4. .  .UR  UNIT? 

I  >25 

2S  IS  NOT  UITHIN  THE  LIMITS!  C  0.00 

4.. . UR  LIMIT? 

I>3 

5.. .5. PERCENT  LESS  THAN  200? 

I>2S 

6.. . FIELD  MOLD  SIZE? 

I>6 

REUIEU  OF  INPUT 


LINE  *  DATA  VALUE 

1  . 95.0 

2  . SU 

3  . -1 

4  . 3 

5  . 25 

6  . 6 


TO  CHANGE  AN  ITEM,  TYPE  ITS  LINE  0 

OTHERWISE  HIT  RETURN 

I>3 

3...UL  LIMIT? 

I>-6 


3.. 

I>- 


-6  IS  NOT  UITHIN  THE  LIMITS! 
•UL  LIMIT? 


-3.« 


TO  CHANGE  AN  ITEM,  TYPE  ITS  LINE  0 
OTHERWISE  HIT  RETURN 
I> 


12.00  3 


0.00  3 


(Continued) 


Table  6  (Continued) 


1... COMPACTION  PERCENT? 

DSU 

OOPS!  NOT  A  UAUD  REAL,  TRY  AGAIN 


1... COMPACTION  PERCENT? 

1)99.9 

99. 900  IS  NOT  U1THIN  THE  LIMITS!  C  9*. 

1... COMPACTION  PERCENT? 

1)95.0 

TO  CHANGE  AN  ITEM,  TYPE  ITS  LINE  t 
OTHERWISE  HIT  RETURN 
I) 

DO  YOU  WISH  TO  REVIEW  VALUES  AGAIN?  (Y  OR  N) 


I)V 

REVIEW  OF  INPUT 


LINE  «  DATA  VALUE 

1  . 95. 0 

2  . SV 

3  . -2 

4  . 3 

5  . 25 

6  . 6 


TO  CHANGE  AN  ITEM,  TYPE  ITS  LINE  * 
OTHERWISE  HIT  RETURN 
I) 

,1... REPORT  NUMBER (INPUT  A  0  TO  GUIT)? 

t>l 

IS  THIS  A  NEW  REPORT?  (V  OR  N) 

1>V 

1.. . BEGINNING  DATE?  CNM/'DD'VYYY ) 
1)02/24/1981 

2.. . TYPE  EQUIPMENT?! 15  CHAR.  MAX) 
DSHEEPFOOT  ROL 

3.. . LOOSE  LIFT  THICKNESS? 

1)6 

4.. . COMPACTED  LIFT  THICKNESS? 

1)4 

5.. . NUMBER  OF  PASSES? 

1)6 

6.. . LAB  COMPACTION  EFFORT? 

DMOD 

REVIEW  OF  INPUT 


LINE  i  DATA  VALUE 

1  .  02/24/1981 

2  . SHEEPFOOT  ROL 

3  . 6 

4  .  4 

5  . 6 

6  . MOD 


TO  CHANGE  AN  ITEM,  TYPE  ITS  LINE  * 
OTHERWISE  HIT  RETURN 
I) 


(Continued) 


(Sheet  3  of  8) 


Table  6  (Continued) 


1.. .naxihuh  particle  size? 
i>i.7s 

2.. . FIELD  UET  DENSITY? 

1)134.0 

3.. . QUICK  FIELD  WATER  CONTENT? 

ma.e 

4.. . QUICK  FIELD  DRV  DENSITV? 

mas.i 

5.. . FINAL  FIELD  WATER  CONTENT? 

I>2 1.1 

6.. . FINAL  FIELD  DRV  DENSITV? 
I>124.0 

7.. . LABORATORY  HOLD  SIZE? 

1>S 

8. .  .QUICK  ONE-POINT  WATER  CONTENT? 
1)126.0 

9.. . QUICK  ONE-POINT  DRV  DENSITV? 
I>126.0 

REVIEW  OF  INPUT 

LINE  *  DATA  UALUE 

1  .  1.75 

2  .  134.0 

3  .  12.2 

4  .  125.1 

5  . 21.1 

6  .  124.0 

7  . 6 

8  .  126.0 

9 .  126.0 

TO  CHANGE  AN  ITER,  TYPE  ITS  LINE  • 

OTHERWISE  HIT  RETURN 

I>5 

5.. . FINAL  FIELD  WATER  CONTENT? 
1)11.9 

TO  CHANGE  AN  ITEH.  TYPE  ITS  LINE  t 

OTHERWISE  HIT  RETURN 

I>6 

6. .  .FINAL  FIELD  DRV  DENSITY? 

I>124.5 

TO  CHANGE  AN  I TEN,  TYPE  ITS  LINE  0 

OTHERWISE  HIT  RETURN 

I>8 

8.. . QUICK  ONE-POINT  WATER  CONTENT* 
I>10. 3 

TO  CHANGE  AN  ITEM,  TYPE  ITS  LUC  • 
OTHERWISE  HIT  RETURN 
I> 


(Continued) 
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Table  6  (Continued) 


DO  YOU  WISH  TO  REVIEW  VALUES  MAIN?  (Y  OR  N> 


I)V 

REVIEW  OF  INPUT 

LINE  t  DATA  VALUE 

1  .  1 .75 

2  .  134. • 

3  .  12.2 

4  .  125.1 

5  .  11.9 

6  .  124.5 

7  . 6 

8  .  10.3 

9  .  125.0 

TO  CHANCE  AN  ITEH,  TYPE  ITS  LINE  0 
OTHERWISE  HIT  RETURN 
I> 

1.. . QUICK  OPTIHUN  WATER  CONTENT? 
I>11.4 

2.. . QUICK  HAXIHUfl  DRV  DENSITY? 
1)127.0 

3. .  .0.E-POINT  DRY  DENSITY? 

1)125. S 

4.. . 0.E-POINT  WATER  CONTENT? 

1)9.9 

5.. . 5.COND-POINT  DRY  DENSITY? 

I) 

6.. . 5.COND-POINT  WATER  CONTENT? 

I) 

7.. .F0C  HAXIHUn  DRY  DENSITY? 
1)126.5 

8.. .F0C  OPTIHUN  WATER  CONTENT? 

1)11.0 

9.. . QUICK  X  GREATER  THAN  3/4*? 

1)6 

REVIEU  OF  INPUT 

LI^  t  DATA  VALUE 

1  .  11.4 

2  .  127.0 

3  .  125.5 

4  . 9.9 

5  . 

6  . 

7  .  126.5 

8  .  11.0 

9 . 6 

TO  CHANGE  AN  I  TEN,  TYPE  ITS  LINE  0 
OTHERWISE  HIT  RETURN 
I) 


(Continued) 


Table  6  (Continued) 


1.. .5.D  X  GREATER  THAN  3/4*? 

1)8 

8.. . CORRECTED  FOC  HAXIHUH  DRV  DENSITY? 
1)126.5 

3.. . CORRECTED  FOC  OFT I HUM  WATER  CONTENT? 

1)11.8 

4 . .  . COHHEHTS? ( 38  CHAR.  MAX) 

I)NG 

REVIEW  OF  INPUT 


UNE  8  DATA  VALUE 

1  . 8 

2  .  126.5 

3  .  11.8 

4  . NG 


TO  CHANGE  AN  I TEN,  TYPE  ITS  LINE  8 
OTHERWISE  HIT  RETURN 

I> 

INPUT  THE  TEST  GROUP  <1.2  OR  3) 

INPUT  A  ZERO  TO  QUIT 
1)2 

1.. . 5.POINT  CURUE  NUNBER?(6  CHAR.  NAX) 
DR-722 

2.. . 5.POINT  NAX I NUN  DRY  DENSITY? 

1)132.5 

3.. . 5.POINT  OPT I HUN  WATER  CONTENT? 

1)8.5 

4.. . BULK  SPECIFIC  GRAUITV? 

1)2.78 

5. .  .ABSORPTION? 

1)2.1 

6.. . CORRECTED  S-PT  HAXIHUH  DRV  DENSITY? 
1)132.5 

7.. . CORRECTED  S-PT  OPT I NUN  WATER  CONTENT? 
1)8.5 

REVIEW  OF  INPUT 

LINE  8  DATA  VALUE 

1  . R-722 

2  .  132.5 

3  . 8.5 

4  . 2.78 

5  . 2.1 

6  .  132.5 

7  . 8.5 


TO  CHANGE  AN  ITEH.  TYPE  ITS  LINE  8 
OTHERWISE  HIT  RETURN 


I) 


(Continued) 


Table  6  (Continued) 


INPUT  THE  TEST  GROUP  (1,2  OR  3) 

INPUT  A  ZERO  TO  QUIT 
I>3 

1. .  .SOIL  CLASSIFICATION?!?  CHAR.  BAX  > 
I>HL-Ct 

2.. . LIQUID  LIBIT? 

034 

3.. . PLASTICITY  INDEX? 

018 

4.. . 5.ECIFIC  GRAVITY  OF  SOLIDS? 

I>2.68 

5.. . APPARENT  SPECIFIC  GRAVITY? 

02.69 

6.. . 5.ECIFIC  GRAVITY? 

02.78 

7.. .K  PASSING  *299  SIEVE? 

022 

8.. .X  PASSING  *188  SIEVE? 

038 

9.. .X  PASSING  *48  SIEVE? 

033 

REVIEW  OF  INPUT 

LINE  •  DATA  VALUE 

1  . HL-CL 

2  . 34 

3  .  18 

4  . 2.68 

5  . 2.69 

6  . 2.78 

7  . 22 

8  . 38 

9  . 33 

TO  CHANGE  AN  ITEN.  TYPE  ITS  LINE  * 
OTHERWISE  HIT  RETURN 
I> 

1.. .X  PASSING  *16  SIEVE? 

042 

2.. .«  PASSING  *18  SIEVE? 

049 

3.. .X  PASSING  *4  SIEVE? 

OS2 

4.. .X  PASSING  3/8’  SIEVE? 

069 

5.. .*  PASSING  1/2’  SIEVE? 

065 

6.. .X  PASSING  3/4’  SIEVE? 

079 

7.. .X  PASSING  l’  SIEVE? 

O 


(Continued) 
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Table  6  (Concluded) 


8.. .*  PASSING  l  1/2*  SIEVE? 
1)95 

9.. .H  PASSING  8*  SIEVE? 
I)1M 

REUIEU  OF  INPUT 


LINE  t  DATA  VALUE 

1  . 42 

2  . .  49 

3  . 52 

4  . 69 

5  .  65 

6  . 7# 

7  . 

8  . 95 

9  .  190 


TO  CHANGE  AN  I TEN,  TYPE  ITS  LINE  9 
OTHERWISE  HIT  RETURN 
I> 

1.. .B  PASSING  3*  SIEUE? 

I  >199 

REUIEU  OF  INPUT 
LINE  9  DATA  VALUE 

1  .  199 

TO  CHANGE  AN  ITEM,  TYPE  ITS  LINE  9 
OTHERWISE  HIT  RETURN 
I> 

INPUT  THE  TEST  GROUP  (1,2  OR  3) 

INPUT  A  ZERO  TO  QUIT 
I>0 

IS  THIS  TEST  COMPLETE? (Y  OR  N) 

I>Y 

IS  THIS  TEST  A  RETEST? (V  OR  N) 

I>N 

1 . .  . TEST  NUMBER! INPUT  A  9  TO  OUITI? 

1)9 

IS  THIS  REPORT  PERIOD  COMPLETED?  (Y  OR  N> 
I>N 

1.. . REPORT  NUMiERC INPUT  A  9  TO  QUIT)? 

IS  THIS  A  NEW  REPORT?  (Y  OR  N) 

I>N 

1 . .  .TEST  NUMBER! INPUT  A  9  TO  QUIT)? 

I>9 

IS  THIS  REPORT  PERIOD  COMPLETED?  (V  OR  N) 
I>N 

1.. . REPORT  NUMBER (INPUT  A  9  TO  QUIT)? 

1.. . EMBANKMENT  ZONE (INPUT  END  TO  QUIT)? 
DEND 

DATA  ENTRY  TERMINATED 


Table  7 

Data  Entry  Procedure  for  Existing  Embankment  Zone 
and  Test  Number  Using  Data  File  Option  (Example  4) 


GET.INPAB1 
OCflU.  INPAB1 


DATA  ENTRY  SYS TEN  FOR  DAN  CONSTRUCTION 


1...ENBANKNENT  ZONE ( INPUT  END  TO  QUIT)? 
I>RANDON  1 

IS  THIS  A  NEW  ZONE?  (Y  OR  N) 


1.. . REPORT  NUHBER< INPUT  A  0  TO  QUIT)? 

in 

IS  THIS  A  NEU  REPORT?  (Y  OR  N> 

I>N 

1 . .  . TEST  NUNBER( INPUT  A  0  TO  QUIT)? 

010002 

INPUT  THE  TEST  GROUP  <1.2  OR  3) 

INPUT  A  ZERO  TO  QUIT 
I>1 

1 . .  . TEST  DATE?  <  NH/DD/VVYY ) 
002/23/1981 

2.. .QA  OR  QC  LAB?< 1  CHAR.  NAX) 

OC 

3. .  .STATION'’ <6  CHAR.  NAX) 

010+75 

4.. . 0.FSET? 

0-1010 

5.. .ELEUATI0N? 

I>3S2.9 

G... DEPTH  IN  INCHES? 

06 

7.. .NATERIAL  SOURCE?<10  CHAR.  NAX) 
I>BOR  I 

8.. . 501.  CLASSIFICATION? <7  CHAR.  NAX) 
I>GC 

9.. . 501.  COLOR? (4  CHAR.  NAX) 

DDRBN 

REUIEU  OF  INPUT 

LINE  t  DATA  VALUE 

1  .  02/23/1981 

2  . C 

3  .  10+75 

4  . -1010 

5  .  352.9 

6  .  6 

? . BOR  I 

8  . GC 

9  .  DR  BN 

TO  CHANGE  AN  I TEN,  TYPE  ITS  l!K  B 
OTHERWISE  HIT  RETURN 

O 


(Continued) 
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Table  7  (Continued) 


(Continued) 


Table  7  (Continued) 
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Table  7  (Continued) 


INPUT  THE  TEST  GROUP  <1,8  OR  3) 

INPUT  ft  ZERO  TO  QUIT 

!>• 

IS  THIS  TEST  COHPLETE?(V  OR  N) 

I>N 

IS  THIS  TEST  ft  RETEST? (V  OR  N) 

I>V 

INPUT  THE  ORIGINAL  TEST  NUHBER 
I) 10601 

1. . .TEST  NUNBER (INPUT  ft  0  TO  QUIT)? 

I >10603 

INPUT  THE  TEST  GROUP  (1,2  OR  3) 

INPUT  ft  ZERO  TO  OUIT 
I>0 

IS  THIS  TEST  COHPLETE?(Y  OR  N> 

ON 

IS  THIS  TEST  A  RETEST? (V  OR  N) 

ON 

1. .  .TEST  NUNBER( INPUT  ft  0  TO  QUIT)? 
010002 

INPUT  THE  TEST  GROUP  (1,2  OR  3) 

INPUT  A  ZERO  TO  OUIT 
03 

1 . .  .501.  CLASSIFICATION?!?  CHAR.  HAH) 
OGC 

2.. . LIQUID  LIHIT? 

021 

3.. . PLASTICITY  1NDEH? 

O10 

4.. . 5.ECIFIC  GRflUITY  OF  SOLIDS? 

02.7-4 

5.. . APPARENT  SPECIFIC  GRAVITY? 

O 

6.. . 5.ECIFIC  GRAVITY? 

02.72 

7.. .X  PASSING  0200  SIEUE? 

026 

8.. .X  PASSING  0100  SIEVE? 

030 

9.. .X  PASSING  640  SIEVE? 

037 

REVIEU  OF  INPUT 

LINE  0  DATA  VALUE 

1  . GC 

2  . 21 

3  .  10 

4  . 2.74 

5  . 

6  . 2.72 

7  . 26 

8  .  30 

9  .  37 

TO  CHANGE  AN  I TEH.  TYPE  ITS  LINE  0 
OTHERWISE  HIT  RETURN 
I> 


(Continued) 


Table  7  (Continued) 


1 .. .*  PASSING  SIS  SIEVE? 

I>43 

2.. .*  PASSING  SIS  SIEVE? 

I>50 

3.. .X  PASSING  *4  SIEVE? 

I>5S 

4.. .*  PASSING  3/8*  SIEVE? 

I>69 

5.. .5. PASSING  1/2*  SIEVE? 

I> 

6.. .*  PASSING  3/4*  SIEVE? 

I>75 

7.. .*  PASSING  1*  SIEVE? 

I  >89 

8.. .X  PASSING  1  1/2*  SIEVE? 

I>90 

9.. .X  PASSING  2*  SIEVE? 

mee 

REVIEW  OF  INPUT 

LINE  S  DATA  VALUE 

1  . 43 

2  . 59 

3  . 55 

4  . 69 

5  . 

6  . 75 

7  . 89 

8  . 39 

9  .  199 

TO  CHANGE  AN  ITER,  TYPE  ITS  LINE  S 

OTHERWISE  HIT  RETURN 
I> 

1.. .X  PASSING  3*  SIEVE? 

I> 

REVIEW  OF  INPUT 
LINE  *  DATA  VALUE 

1  . 

TO  CHANGE  AN  ITER,  TYPE  ITS  LINE  • 
OTHERWISE  HIT  RETURN 
I> 


(Continued) 


Table  7  (Concluded) 


INPUT  THE  TEST  GROUP  (1,2  OR  3) 

INPUT  A  ZERO  TO  QUIT 

I>0 

IS  THIS  TEST  COMPLETE? ( V  OR  N) 

I>Y 

IS  THIS  TEST  A  RETEST? (V  OR  N) 

I>N 

1. . .TEST  NUMBER ( INPUT  A  0  TO  QUIT)? 

i> 10001 

INPUT  THE  TEST  GROUP  <1,2  OR  3) 

INPUT  A  ZERO  TO  QUIT 

I>0 

IS  THIS  TEST  COMPLETE? (V  OR  N) 

I>N 

IS  THIS  TEST  A  RETEST? (Y  OR  N) 

I>N 

1...TEST  NUNBERC INPUT  A  0  TO  QUIT)? 

I>0 

IS  THIS  REPORT  PERIOD  COMPLETED?  <Y  OR  N) 
I>V 

TYPE  THE  REPORT  END  DATE  (MM/DD/YVYY)'? 


I>02/' 28/1981 

ARE  THERE  ANY  NOTES  FOR  THIS  REPORT'? (V  OR  N) 
I>N 

1.. . REPORT  NUMBER! INPUT  A  0  TO  QUIT)? 

I>0 

1 . .  .EMBANKMENT  ZONE (INPUT  END  TO  OUIT>? 
I>END 

DATA  ENTRY  TERMINATED 


C> 
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Interactive  Data  Modifications 


Description 

38.  There  are  a  number  of  commands  that  can  either  add  or  modify 
data  when  the  user  is  working  on  line  with  the  data  base.  Of  these, 
there  are  three  commands  that  the  user  of  this  data  base  system  should 
be  aware  of;  they  are  ADD,  CHANGE,  and  REMOVE.  Each  of  these  commands 
will  be  described  in  detail  with  additional  examples  shown  at  the  end  of 
this  Part.  These  three  commands  deal  with  adding  to  or  modifying  exist¬ 
ing  data  groups;  if  the  user  wants  to  insert  new  data  groups,  he  should 
either  use  the  data  entry  program  or  refer  to  the  System  2000 
documentation.  The  data  base  can  be  damaged  in  this  interactive  mode 
and  a  backup  copy  is  recommended  (see  Appendix  E) .  Before  using  these 
commands,  the  user  must  understand  the  WHERE-clause  information  discussed 
in  Part  IV  because  each  of  these  commands  will  modify  or  add  data  as 
specified;  thus  each  command  must  uniquely  identify  the  data  set  (em¬ 
bankment  zone,  report  period,  or  test  number)  so  that  only  the  intended 
data  is  changed.  After  each  command  is  executed,  the  computer  will  re¬ 
spond  with  the  number  of  selected  data  sets  that  were  modified.  If  more 
data  sets  are  involved  than  the  user  expected,  he  needs  to  determine 
what  else  was  modified  so  that  corrective  measures  can  be  performed. 

ji.  ADD  command.  The  ADD  command  is  used  to  add  one  or  sever¬ 
al  elements  of  data  to  an  existing  data  group  where  no 
data  presently  exists.  This  command  is  used  when  a  few 
elements  of  data  need  to  be  added  to  a  data  group.  In 
Example  1  (the  last  line  on  sheet  8  of  Table  4),  no  value 
was  entered  for  the  "%  passing  1"  SIEVE"  (GR1I)  in  test 
number  (NO.)  10001.  The  data  were  loaded  to  the  data  base 
before  the  user  realized  that  the  "%  passing  1"  SIEVE" 
(GR1I)  should  be  equal  to  75.  To  add  this  value  the  user 
must  be  on  line  with  the  data  base  and  issue  the  add 
command : 

ADD  GR1I  EQ  75*WHERE  NO.  EQ  10001; 

Computer  response  of: 

1  SELECTED  DATA  SET 

indicates  that  the  value  was  added  to  the  data  base.  Test 
number  (NO.)  10001  is  the  specifier  in  the  where  clause, 
since  it  identifies  a  unique  place  in  the  data  base  for 
the  75%  passing  1"  sieve. 


Some  typical  examples  of  the  ADD  command  are: 

ADD  ELE  EQ  350.0*WHERE  NO  EQ  10112; 

ADD  C71  EQ  350. 0*WHERE  C61  EQ  10112; 

ADD  LLT  EQ  6*WHERE  C21  EQ  RANDOM  I  AND  REPORT-NO 

EQ  20; 

ADD  TESTS  EQ  63*U*67*24+50*END*WHERE  C61  EQ  10113; 

The  data  element  names  and  component  numbers  are  defined 
in  Table  1.  All  data  base  commands  must  end  with  a  semi¬ 
colon  (;)  and  the  asterisk  (*)  is  the  system  separator. 

The  equal  operation  (EQ)  is  the  only  valid  operator  for 
the  add  command.  The  second  command,  using  the  data  ele¬ 
ment  names,  will  add  the  number  350.0  as  the  elevation  to 
test  number  10112,  provided  that  there  is  not  an  elevation 
existing  for  that  test.  If  an  elevation  did  exist  for 
test  10112,  nothing  would  have  been  added  and  the  system 
would  tell  the  user  zero  data  sets  were  selected.  The 
second  command  is  the  same  as  the  first,  only  the  compo¬ 
nent  numbers  are  used  instead  of  the  element  name.  The 
first  three  commands  were  identified  by  the  unique  test 
number.  However,  the  fourth  command,  adding  the  loose 
lift  thickness  to  the  report  information,  must  be  identi¬ 
fied  by  both  embankment  zone  and  report  number.  The  last 
command  illustrates  adding  two  elements  to  the  same  test 
number.  Both  elements  are  located  in  the  TESTS  repeating 
group  and  are  component  numbers  63  and  67,  where  63  equals 
U  and  67  equals  24+70.  When  multiple  elements  are  added, 
the  word  "END*"  must  appear  after  the  last  value  to  be 
added;  otherwise  the  command  will  not  be  accepted.  Multi¬ 
ple  elements  that  are  not  in  the  same  repeating  group  can¬ 
not  be  added  in  the  same  command. 

CHANGE  command.  The  CHANGE  command  is  used  to  modify  one 
or  several  existing  data  element  values.  This  command  is 
used  to  correct  errors  that  are  found  in  the  data  base. 

Two  examples  of  the  CHANGE  command  are: 

CHANGE  ELE  EQ  351.0*WHERE  NO  EQ  10001; 

CHANGE  TESTS  EQ  67*25+40*71*350. 0*END*WHERE  NO 

EQ  10112; 

All  the  nomenclature  is  defined  in  Table  1  or  for  the  ADD 
command.  The  value  after  the  equal  is  always  the  correct¬ 
ed  value.  The  first  command  will  change  the  elevation 
from  345.8  (Example  1,  page  3)  to  351.0  for  test  10001. 

The  second  command  will  change  the  station  (C67),  and 
elevation  (C71),  for  test  10112.  All  the  details  of  the 
CHANGE  command  are  the  same  as  the  ADD  command. 


REMOVE  command.  The  purpose  of  the  REMOVE  command  is  to 
delete  data  from  the  data  base.  The  user  is  reminded  of 
the  importance  of  uniquely  defining  the  data  to  be  removed 
so  that  other  data  are  not  lost.  An  example  of  the  REMOVE 
command  is: 

REMOVE  END- DATE  WHERE  C21  EQ  RANDOM  I  AND 

C35  EQ  20; 

The  nomenclature  has  been  previously  defined.  This  exam¬ 
ple  removes  the  end  date  of  report  20  of  Random  I  from  the 
data  base.  Multiple  data  elements  cannot  be  removed  by 
using  one  command;  however,  one  of  the  following  examples 
illustrates  how  a  complete  test  is  removed. 

Examples 

39.  The  following  examples  illustrate  some  typical  uses  of  the 
ADD,  CHANGE,  and  REMOVE  commands. 

ji.  ADD  command ,  When  data  is  entered  to  the  data  base  by  one 
of  the  first  two  procedures  described  in  this  Part,  sever¬ 
al  data  elements  will  invariably  be  missing.  These  values 
are  entered  into  the  data  base  with  the  ADD  command  as  the 
following  examples  illustrate.  These  examples  include  not 
only  the  user-entered  command  but  also  the  computer 
response. 

(1)  Adding  the  liquid  limit  for  test  number  10112.  The  user 
is  reminded  that  if  the  test  numbers  are  not  unique  for 
the  entire  project,  both  the  embankment  zone  and  test 
number  may  be  needed  to  uniquely  identify  the  test  number 
for  which  the  liquid  limit  is  being  added. 

I  >  ADD  LL  EQ  23*  WHERE  NO  EQ  10112; 

1  SELECTED  DATA  SETS  - 


(2)  Adding  the  spec'fic  gravity  (C148),  specific  gravity  of 
solids  (C145),  tpparent  specific  gravity  (C146) ,  and  bulk 
specific  gravity  (047)  for  test  number  10112.  The  ele¬ 
ment  component  number  must  be  used  when  adding  more  than 
one  element  at  a  time. 

I  >  ADD  TESTS  F.Q  148*2.70*145*2.72*146*2.68*147*2.65* 

I >  END*  WHERE  NO  EQ  10112; 

1  SELECTED  DATA  SETS  - 


71 


(3)  Adding  the  maximum  dry  density  (C107)  and  the  percent  com¬ 
paction  (C113)  for  test  number  (C61)  10112.  The  user  is 
reminded  that  the  percent  compaction  and  deviation  from 
optimum  water  content  are  not  calculated  if  one  of  the 
elements  needed  in  the  calculation  is  added  with  this 
c  ommand . 

I  > ADD  TESTS  EQ  10-7*130. 2*113*98. 1*END* 

I > WHERE  C61  EQ  10112; 

1  SELECTED  DATA  SETS  - 

_b.  CHANGE  command.  When  the  wrong  data  values  are  entered 
into  the  data  base,  the  CHANGE  command  is  used  to  correct 
the  values.  The  following  examples  include  not  only  the 
user-entered  commands  (lines  beginning  with  I>)  but  also 
the  computer  response. 

(1)  Changing  the  liquid  limit  for  test  number  10112  from  25  to 
27.  The  user  is  reminded  that  only  the  correct  value  is 
used  in  the  command. 

I > CHANCE  LL  EQ  27*  WHERE  NO  EQ  10112; 

SELECTED  DATA  SETS  - 


If  the  user  attempts  to  change  a  value  that  is  the  same  as 
the  existing  value,  the  data  base  will  be  unaltered  as 
shown . 

I > CHANGE  LL  EQ  25*  WHERE  NO  EQ  10112; 

1  SELECTED  DATA  SETS  - 
-  DATA  BASE  UNALTERED  - 

(2)  Changing  the  maximum  dry  density  and  the  percent  compac¬ 
tion  for  test  number  10112  from  what  was  added  in  subpara¬ 
graph  a^3)  to  a  maximum  dry  density  of  131.8  pcf  and  a 
percent  compaction  of  99.0  percent. 

I  >  CHANCE  TESTS  EQ  10 7*131 . 8*1 13*99 .0*END* 

I > WHERE  NO  EQ  10112; 

1  SELECTED  DATA  SETS  - 
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c.  REMOVE  command.  This  command  is  used  when  a  data  element 
was  erroneously  added  to  a  test  number,  or  if  a  large  num¬ 
ber  of  data  values  are  wrong,  the  user  may  remove  the  test 
number  and  reenter  the  data  with  one  of  the  procedures  de¬ 
scribed  in  the  beginning  of  this  Part. 

(1)  Removing  the  liquid  limit  value  for  test  number  10112. 

The  user  is  reminded  that  the  data  to  be  removed  must  be 
uniquely  identified. 

I > REMOVE  LL  WHERE  NO  EQ  10112; 

1  SELECTED  DATA  SETS  - 

(2)  Removing  test  number  10112  from  the  data  base. 

I  > REMOVE  TREE  TESTS  WHERE  NO  EQ  10112; 

1  SELECTED  DATA  SETS  - 

The  word  "TREE"  followed  by  C60  (tests)  represents  the 
whole  test  group  from  C61  to  C163.  However,  the  command: 

I  > REMOVE  C61  WHERE  C61  EQ  10112; 

would  only  delete  C61,  test  number  10112. 


PART  IV:  DATA  OUTPUT  MODULE 


40.  There  are  three  methods  of  retrieving  data  from  the  data  base 
and  one  procedure  to  obtain  graphic  plots  from  this  system.  The  three 
methods  of  retrieving  data  from  the  data  base  are:  ad  hoc,  report 
writer,  and  program  language  extension  (PLEX).  The  ad  hoc  retrievals 
are  done  interactively  with  the  data  base  by  asking  questions  using  the 
built-in  system  query  language.  This  is  the  simplest  and  most  flexible 
of  the  three  retrievals  because  the  user  asks  for  the  information  he 
wants  during  the  time-sharing  session.  Each  query  or  question  requires 
a  scan  of  the  data  base  files.  The  report  writer  retrievals  provide  the 
user  with  the  capability  to  define  and  generate  formulated  reports  from 
a  single  scan  of  the  data  base  files.  The  reports  can  be  developed  in¬ 
teractively  while  using  System  2000  (expensive)  or  separately  from  the 
data  base  using  GENIUS  (page  90)  to  quickly  build  a  file  that  is  invoked 
when  using  the  data  base.  The  report  writer  requires  the  user  to  have 
some  knowledge  of  the  data  base  query  language  plus  the  report  writer 
features.  The  PLEX  retrievals  are  FORTRAN  programs  that  interface  with 
the  data  base  to  gather  the  data  required  by  the  program.  Some  computer 
programming  experience  is  required  to  generate  these  programs,  but  once 
the  programs  are  written,  they  are  easy  to  use.  The  graphic  procedure 
consists  of  using  either  a  series  of  ad  hoc  retrievals  or  a  report  writer 
file  to  create  a  data  file  that  is  accessed  by  the  graphic  program.  In 

any  retrieval,  " — SHARED  DBN  IS - "  should  be  used  to  open  the  data  base 

for  read  only  and  prevent  accidental  damage.  This  form  also  allows 
other  users  to  read  the  data  base  at  the  same  time.  The  next  four  sec¬ 
tions  of  this  part  will  describe  each  of  the  retrieval  methods  and  the 
graphic  procedure  with  examples  illustrated  both  in  the  text  and  with  a 
separate  heading  at  the  end  of  each  section  which  will  include  some  ex¬ 
amples  with  the  system  response.  The  costs  for  the  various  retrieval 
methods  will  be  dependent  on  what  is  to  be  requested  (the  number  of 
times  the  system  must  search  its  files  for  data),  the  data  base  size, 
and  other  user-dependent  variables.  The  costs  to  generate  the  examples 
will  be  included  in  the  example  descriptions. 


41.  System  2000  allows  commands  to  be  entered  on  multiple  lines 
from  the  user's  time-sharing  terminal.  All  data  base  commands  must  end 
in  a  semicolon  (;).  The  system  will  not  execute  any  command  until  the 
semicolon  is  encountered.  If  multiple  lines  are  used  to  input  a  com¬ 
mand,  always  type  a  space  at  the  beginning  of  each  line. 

42.  When  the  user  has  finished  working  in  the  data  base,  the 
following  command  will  close  the  data  base  and  allow  the  user  to  leave 
the  data  base: 

EXIT; 

If  this  command  does  not  work  the  first  time,  the  following  will  always 
work: 

;  EXIT; 

If  a  query  or  command  produces  an  unwanted  listing,  the  user  can  some¬ 
times  stop  the  printing  by  using  the  "Break"  or  "Interrupt"  key  on  the 
terminal. 


Output  Files 


43.  Sometimes  the  user  would  like  to  save  some  of  the  data  base 
output  in  the  computer  files  for  future  analysis  or  reference.  This  can 
be  done  by  directing  the  output  to  a  file.  This  feature  of  the  data 
base  is  very  important  when  the  user  wants  to  generate  graphic  plots. 

In  addition,  if  the  user  is  using  this  data  in  a  report  or  for  analysis, 
it  would  be  desirable  for  the  commands  used  to  generate  the  data  to  be 
available.  The  following  discussion  describes  how  the  output  and  com¬ 
mands  can  be  saved  in  files. 

a_.  Report  files.  Normally  the  Report  File,  which  will  con¬ 
tain  the  results  from  the  user's  queries,  is  assigned  to 
OUTPUT,  which  is  the  user's  teletype  terminal.  However, 
the  user  can  assign  the  results  to  an  OUTPUT  File  which 
can  then  be  saved.  The  following  sequence  of  commands  are 
used : 

REPORT  FILE  IS  0UT1; 

"Ad  Hoc  Retrieval  or  Report  Writer  Commands" 


REPORT  FILE  IS  OUTPUT; 


In  this  example  the  ad  hoc  retrieval  or  report  writer 
output  would  be  sent  to  file  0UT1.  The  last  statement 
returns  the  output  to  the  user's  terminal  for  any  other 
commands.  After  the  user  has  exited  from  the  data  base, 
the  following  command  is  used  to  make  the  output  file 
permanent : 

SAVE.0UT1 

The  file  0UT1  is  then  accessed  like  any  other  file  on  the 
BCS . 

Jb.  Message  file.  This  file  contains  a  list  of  the  user 
commands  and  any  error  messages  that  result  from  those 
commands.  A  file  name  can  be  assigned  to  this  file  just 
like  the  Report  File  above.  Initially  this  file  is  set  to 
OUTPUT  each  time  the  user  starts  a  data  base  session.  An 
example  of  this  comand  is: 

MESSAGE  FILE  IS  LIST1; 

The  user  can  assign  the  MESSAGE  FILE  to  the  same  file  name 
as  the  REPORT  FILE  to  document  the  queries  that  are  listed. 
An  example  of  this  procedure  is: 

REPORT  FILE  IS  0UT2; 

MESSACE  FILE  IS  0UT2; 

"Ad  Hoc  Retrieval  or  Report  Writer  Commands" 

REPORT  FILE  IS  OUTPUT; 

Ad  Hoc  Retrievals 

Description 

44.  The  ad  hoc  query  retrievals  are  designed  to  allow  the  user  to 
browse  or  retrieve  data.  These  retrievals  are  generally  simple  requests 
that  the  user  initiates  during  a  time-sharing  session.  Some  requests 
can  become  complicated  with  titles  and  paging  information,  but  the  costs 
of  these  requests  generally  dictates  that  the  report  writer  be  used.  To 
facilitate  the  ad  hoc  feature  of  the  data  base,  a  query  language  has 
been  developed  that  contains  certain  commands,  clauses,  and  operators 
the  data  base  understands.  The  following  discussion  of  the  query  lan¬ 
guage  is  not  an  exhaustive  reference,  but  various  components  are  de¬ 
scribed  that  are  used  with  this  particular  data  base  so  that  a  user  can 
interrogate  this  system.  The  user  is  referred  to  the  System  2000  QUEST 
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Manual  (Intel  Systems  Corporation  1981)  for  more  detailed  information  on 

the  query  language.  All  data  base  element  names  and  component  numbers 

used  in  the  example  in  this  section  are  described  in  Table  1. 

a_.  PRINT  command.  The  PRINT  command  allows  the  user  to  print 
any  data  from  the  data  base  in  a  sequential  vertical  list. 
Two  examples  would  be : 

PRINT  ZONES; 

PRINT  ZONES  WHERE  EMBANK  ZONE  EQ  RANDOM  I; 

The  first  request  will  print  all  the  data  for  all  zones, 
while  the  second  request  will  print  all  the  data  for  just 
Random  I  zone.  Besides  requesting  repeating  groups,  indi¬ 
vidual  data  elements  (identified  by  data  element  name  or 
component  number)  can  be  used  as  the  following  example 
shows : 

PRINT  NO,  C65,  PC,  DOWC  WHERE  EMBANK  ZONE  EQ 

RANDOM  I  AND  C65  EQ  08/13/1981; 

This  example  would  print  the  test  number,  date  made,  per¬ 
cent  compaction,  and  deviation  from  optimum  water  content 
for  all  the  tests  made  on  08/13/1981  for  Random  I  zone. 

The  print  command  lists  one  data  item  with  the  data  base 
component  number  per  line.  The  data  element  name  can  be 
printed  instead  of  the  component  number  by  using  NAME  as 
shown  in  the  following  example  which  produces  the  same 
result  as  the  previous  example  except  that  the  element 
names  are  printed  with  the  results  instead  of  the  compo¬ 
nent  number: 

PRINT/NAME/NO, C65, PC, DOWC  WHERE  EMBANK  ZONE  EQ 

RANDOM  I  AND  C65  EQ  08/13/1981; 

Print  statements  can  be  used  with  any  correct  WHERE 
clause,  ORDERING  clause,  and  BY  lists,  examples  of  which 
will  be  shown  when  they  are  described  later  in  this 
section . 

_b.  LIST  command .  The  LIST  command  is  similar  to  the  print 
command  except  that  the  data  values  are  spread  across  the 
page  in  a  tabular  format  with  the  data  element  name  at  the 
top  of  each  column.  Several  examples  of  list  commands 
are : 

LIST  EMBANK-ZONE,  REPORT- NO. ,  BECIN-DATE,  END-DATE; 

LIST  REPORT-NO.,  BEGIN-DATE,  END-DATE  WHERE  EMBANK- 
ZONE  EQ  RANDOM  I; 

LIST  C55,  C41 ,  C43  WHERE  C21  EQ  RANDOM  I; 

LIST  REPORT-NO.,  C41,  C43  WHERE  C21  EQ  RANDOM  I; 
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The  first  example  request  would  list  all  the  indicated 
data  for  all  embankment  zones,  while  the  second  example 
would  list  the  data  for  only  RANDOM  I  zone.  The  output 
from  the  second,  third,  and  fourth  examples  are  the  same. 
The  third  example  shows  that  component  numbers  can  be  used 
instead  of  data  element  names.  Component  numbers  and  data 
element  names  can  be  mixed  within  the  same  command  as  the 
fourth  example  illustrates.  As  with  the  print  command, 
the  list  command  can  be  used  with  WHERE  clauses,  ORDERING 
clauses,  and  BY  lists,  examples  of  which  will  be  shown 
when  they  are  described  later  in  this  section.  In  addi¬ 
tion,  with  the  list  command,  titles,  page  headings,  and 
footnotes  can  be  added  to  the  output  along  with  formatting 
where  the  data  are  located  on  the  page.  These  options 
dealing  with  page  formatting  will  be  described  in  the 
paragraph  "Formatted  list  commands." 

WHERE  clauses.  The  WHERE  clause  is  used  to  specify  the 
data  set  that  the  user  is  interested  in  obtaining.  These 
clauses  consist  of  a  series  of  phrases  that  contain  either 
the  component  number  or  element  name,  an  operator,  and  the 
value  or  condition.  The  following  are  examples  of  the 
different  types  of  operators  that  are  available: 

LIST  NO  WHERE  USE  FAILS;  (does  not  have  a  value) 

LIST  NO  WHERE  USE  EXISTS;  (has  a  value) 

LIST  NO  WHERE  PC  GT  99.0;  (percent  compaction  greater 
than  99.0) 

LIST  NO  WHERE  PC  GE  99.0;  (percent  compaction  greater 
than  or  equal  to  99.0) 

LIST  NO  WHERE  PC  LT  99.0;  (percent  compaction  less 
than  99.0) 

LIST  NO  WHERE  PC  LE  99.0;  (percent  compaction  less 
than  or  equal  to  99.0) 

LIST  NO  WHERE  PC  EQ  99.0;  (percent  compaction  equal 
to  99.0) 

LIST  NO  WHERE  PC  NE  99.0;  (percent  compaction  is  not 
equal  to  99.0) 

LIST  NO  WHERE  PC  SPANS  95.0*  99.0;  (percent  compaction 
is  equal  to  95.0  thru  99.0) 

LIST  N0  WHERE  PC  EQ  95.0*  99.0;  (percent  compaction  is 
equal  to  95.0  thru  99.0) 

LIST  NO  WHERE  PC  NE  95.0*  99.0;  (percent  compaction  is 
not  equal  to  95.0  thru  99.0) 

WHERE  clauses  can  be  combined  using  AND  and  OR  c'vt. lectors 
and  using  parentheses  to  group  conditions  for  clarity. 


This  gives  the  user  the  capability  to  ask  some  complex 
questions  as  the  following  example  indicates: 

LIST  NO  WHERE  C21  EQ  RANDOM  I  and  C55  EQ  20  AND 
(PC  NE  95.0*  99.0  OR  DOWC  NE  -1.0*  2.0); 

When  using  WHERE  clauses,  the  user  must  ensure  the  varia¬ 
bles  in  the  clause  are  KEY  variables  and  that  they  are  in 
the  same  repeating  group  as  the  variables  in  the  LIST  or 
PRINT  command. 

<1.  Sys tern  fu nc t ion ■  In  addition  to  listing  (or  printing)  the 
data  elements  themselves.  System  2000  can  generate  the 
following  statistical  information: 

COUNT(PC)  -  count  how  many  percent  compaction  values 
exist 

MIN(PC)  -  determine  the  minimum  percent  compaction 

MAX(PC)  -  determine  the  maximum  percent  compaction 

AVG(PC)  -  determine  the  average  of  the  percent  com¬ 
paction  values 

SUM(PC)  -  generate  the  summation  of  the  percent  com¬ 
paction  values 

SIGMA(PC)  -  generate  the  standard  deviation  of  the 
percent  compaction 

These  functions  can  only  be  used  in  the  LIST  or  PRINT 
commands  as  the  following  example  illustrates,  not  in  a 
WHERE  clause. 

LIST  COUNT(PC) ,  SUM(PC),  AVG(PC),  MIN(PC),  MAX (PC) , 
SIGMA(PC)  WHERE  C21  EQ  RANDOM  I  AND  C55  EQ  20  AND 
USE  FAILS; 

js.  DITTO  command.  After  successfully  typing  a  long  query  and 
obtaining  the  desired  results,  the  user  would  like  the 
same  information  for  a  different  WHERE-clause  condition. 
The  DITTO  command  causes  the  previous  command  on  the  left 
of  the  WHERE-clause  to  be  reused .  Using  the  example  in  jd , 
the  user  would  enter  the  following  to  obtain  the  same 
information  for  report  number  21: 

DITTO  WHERE  C21  EQ  RANDOM  I  AND  C55  E021  AND  USE  FAILS; 

_f .  SAME  command.  The  SAME  command  does  the  same  as  the  DITTO 
command  except  that  it  works  on  the  right  side  of  the 
WHERE  clause.  The  following  example  illustrates  this 
command : 

LIST  NO  WHERE  C21  EQ  RANDOM  I  AND  C55  EQ  20  AND  ELE 
EQ  350.*  360.  AND  USE  FAILS; 

LIST  STA, OFT  WHERE  SAME; 
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Both  the  DITTO  and  SAME  commands  can  be  combined  in  the 
same  LIST  or  PRINT  command.  When  this  occurs,  the  report 
is  duplicated.  This  may  be  useful  if  some  printout  was 
lost  due  to  transmission  error  or  some  other  problem. 

Also  the  SAME  command  has  an  additive  capability;  thus  the 
user  can  narrow  data  of  interest  as  shown  in  the  following 
example : 

LIST  NO  WHERE  C21  EQ  RANDOM  I  AND  C55  EQ  20  AND  USE 
EXISTS; 

LIST  NO  WHERE  SAME  AND  ELE  EQ  350.*  360.; 

DITTO  WHERE  SAME  AND  OFT  GE  0.0; 

The  first  example  defines  the  data  group  to  a  zone,  a 
report  number,  and  to  failing  tests.  The  second  query 
further  narrows  the  data  group  to  between  elevation  350 
and  360.  The  last  query  refines  the  data  group  to  only 
the  upstream  tests.  If  the  OR  connectors  are  used  instead 
of  the  AND  connectors,  the  data  group  can  be  enlarged. 

TALLY  command .  The  TALLY  command  is  used  to  obtain  cer¬ 
tain  basic  information  on  KEY  data  elements.  There  are 
two  types  of  TALLY  commands,  ALL  and  EACH.  The  following 
information  can  be  obtained  for  each  of  these  types: 

A)  MAXIMUM  AND  MINIMUM  VALUES  OF  REQUESTED  ELEMENT 
(/ALL/) 

B)  NUMBER  OF  OCCURRENCES  OF  THE  ELEMENTS  REQUESTED 
ELEMENT  (/ALL/) 

C)  NUMBER  OF  UNIQUE  VALUES  OF  THE  ELEMENTS  RE0UESTED 
ELEMENT  (/ALL/) 

D)  THE  UNIQUE  VALUES  FOR  REQUESTED  ELEMENT  (/EACH/) 

E)  THE  NUMBER  OF  OCCURRENCES  OF  EACH  UNIQUE  VALUE 
FOR  REQUESTED  ELEMENT  (/EACH/) 

The  following  examples  illustrate  the  two  types  of  TALLY 
commands : 

TALLY /ALL /NO; 

TALLY/ EACH/USE; 

WHERE-clauses  are  not  allowed  in  a  TALLY  command. 

Some  System  2000  data  bases  have  a  TALLY  function  associ¬ 
ated  with  the  system.  This  function  operates  the  same  as 
the  system  TALLY  except  WHERE-clause  conditions  can  be 
specified.  The  example  illustrates  this  function: 

*TALLY (NO)  WHERE  C21  EQ  RANDOM  I; 

DESCRIBE  command.  The  DESCRIBE  command  will  print  the 
System  2000  directory  of  data  elements.  Component  numbers 


and  element  names  are  listed  along  with  some  other  attri¬ 
butes  that  are  listed  in  Table  1.  The  command  to  list  the 
entire  data  base  is  illustrated  below: 

DESCRIBE; 

To  list  only  part  of  the  data  base,  the  following  command 
would  be  used: 

DESCRIBE  C60  THRU  C80; 

_i.  Ordering  statements.  The  ORDERED  BY  clause  allows  the 

user  to  sequence  the  output  in  ascending  (low)  or  descend¬ 
ing  (high)  order  according  to  data  elements  associated 
with  the  record.  Ascending  order  is  assumed.  For 
example : 

LIST  NO,  STA,  OFT,  ELE,  ORDERED  BY  STA,  OFT  WHERE 
C21  EQ  RANDOM  I; 

will  list  in  increasing  order  for  station  numbers  and 
where  two  or  more  tests  have  the  same  station  number,  in 
increasing  order  for  offset.  If  descending  order  is 
desired,  it  is  recommended  that  the  HIGH  and  LOW  modifiers 
be  attached  in  front  of  each  data  element  as  shown  below. 

LIST  NO,  STA,  OFT,  ELE,  ORDERED  BY  HIGH  STA,  LOW  OFT 
WHERE  ...; 

The  ORDERED  BY  clause  can  also  be  used  in  the  PRINT 
command: 

PRINT  NO,  STA,  OFT,  ELE,  ORDERED  BY  HIGH  STA,  LOW  OFT, 
WHERE 

There  must  be  a  comma  between  the  list  of  data  elements 
and  the  ORDERED  BY  clause.  NON-KEY  data  elements  cannot 
be  specified  in  ordered  statements. 

Abbreviations ■  System  2000  allows  users  to  use  a  number 
of  abbreviations  and  shorthand  notations  to  simplify  their 
queries.  The  valid  abbreviations  are: 

TA  =  TALLY 

LI  =  LIST 

PR  =  PRINT 

WH  =  WHERE 

OB  =  ORDERED  BY 

DI  =  DITTO 

SA  =  SAME 

Jc.  Formatted  LIST  command.  The  LIST  command  can  allow  you  to 
list  information  in  many  different  ways  by  using  the  TITLE 
options.  These  options  would  generally  be  used  for 
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reports  that  require  sorted  lists  of  various  information 
from  the  data  base.  Three  options  can  be  defined  in  the 
TITLE  clause.  These  options  are: 

(1)  D(NN)TEXT  -  ADD  A  REPORT  HEADING  AT  THE  TOP  OF  THE 

REPORT.  THE  CURRENT  DATE  WILL  BE  CEN¬ 
TERED  UNDER  THE  'TEXT'  HEADING.  NOTE: 

DO  NOT  USE  ANY  COMMAS  (',')  IN  YOUR 
HEADING. 

(2)  F (MM) TEXT  -  ADD  A  REPORT  FOOTING  AT  THE  BOTTOM  OF 

EACH  PAGE  AND  SPECIFY  A  PAGE  SIZE. 

(3)  COLUMN-HEADERS  -  MODIFY  THE  HEADERS  ON  EACH  COLUMN 

OF  OUTPUT  TO  PRINT  MULTI-LINE, 
USER-SPECIFIED  COLUMN  HEADERS  IN¬ 
STEAD  OF  DATA  ELEMENT  NAMES.  THE 
USER  WILL  NEED  TO  REFER  TO  THE  FULL 
SYSTEM  2000  DOCUMENTATION  FOR  DE¬ 
TAILS  ABOUT  THIS  OPTION. 

The  following  examples  illustrate  the  page  heading  and 
footnote  options: 

LIST/TITLE  D(NN)TEST/  ...; 

LIST/TITLE  F (MM) TEXT/  ...; 

D(NN)  indicates  you  want  a  descriptive  heading  at  the  top 
of  the  page.  The  current  date  will  be  printed  centered 
undar  your  text  heading.  If  the  TEXT  is  blank,  only  the 
date  will  be  printed.  The  value  NN  is  the  starting  posi¬ 
tion  (in  characters  from  the  left)  of  the  beginning  char¬ 
acter  of  TEXT.  F(MM)  without  TEXT  defines  a  page  size  of 
MM  (try  55).  The  TEXT  will  be  printed  following  one  blank 
line  at  the  bottom  of  each  page  and  will  start  in  the 
leftmost  print  column.  A  bug  in  System  2000  causes  the 
first  character  of  the  footing  not  to  print.  Use  a  deci¬ 
mal  (.)  as  the  first  character  and  there  will  be  no 
problems.  Headings,  footings,  and  column-headers  can  be 
combined  in  one  list  command. 


Example  5 

45.  The  following  data  base  session,  shown  in  Table  8  as 
Example  5,  illustrates  some  of  the  data  sets  selected  by  the  ad  hoc 
retrievals  discussed  earlier.  To  limit  the  amount  of  output  generated, 
some  of  the  WHERE  clauses  are  more  restrictive  in  this  example  than 
shown  in  the  description.  The  three  commands  used  to  access  the  data 
base  are  shown  at  the  beginning  of  the  example.  These  commands  can  be 
put  into  a  user-named  file  for  ease  of  use.  This  session  accessed  the 
Warm  Springs  Dam  data  base  and  cost  about  twenty  dollars. 
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Table  8 

Data  Base  Ad  Hoc  Retrievals  (Example  5) 


OGET,  S2KGET  /UN-CECE2K 
OCALL.S2KGET 
11.54.10.  S2KGET  ( CORPS ) 

* 

C>S2K 

82/03/22.  11.54.14.  BEGIN  SYSTEM  2000  VERSION  2.60F 


DUSER.EUEi  SHARED  DBN  IS  SOILDB; 
-556-  ASSIGNED  SOILDB 


16  3853  82/03/22.  11.24.38 


I>PRINT  EMBANK- ZONE j 
21*  I. C. MAIN  DAM 
21*  I.C.  COFFER 
21*  FILTER 
21*  DRAIN 
21*  RANDOM  II 
21*  RANDOM  III 
21*  O.U.S&G  BAK 
21*  O.U. DRAIN 
21*  O.U. BAK  RAD 
21*  O.U.D&FH  EMB 
21*  SPLU  BAK-RAD 
21*  EXPLO  TESTS 
21*  SPLU  DRAIN 
21*  ROAD  EMB 
21*  RANDOM  I 
21*  DRAIN  DITCH 
21*  RECORD  R-I 
21*  DRAIN  DITCH 
21*  RECORD  I.C. 
21*  RECORD  R-I I 


I>PRINT  N0.C65.PC.D0UC  UHERE  EMBANK-ZONE  EG  RANDOM  I 

I>AND  C65  EG  08/13/1981; 

61*  13026 

65*  08/13/1981 
113*  94.9 

111*  1.0 
61*  13021 

65*  08/13/1981 
113*  96.2 

111*  -0.2 
61*  13022 

65*  08/13/1981 
113*  102.0 
111*  -0.9 
61*  13020 

65*  08/13/1981 
113*  98.9 

111*  0.5 

61*  13023 

65*  08/13/1981 
113*  98.0 

111*  -0.6 

61*  13024 

65*  08/13/1981 
113*  101.6 
111*  -0.8 
61*  1302? 


(Continued) 


Table  8  (Continued) 


65*  @8/13/1981 
113*  99.5 

lilt  1.0 

61*  13028 

65*  08/13/1981 
113*  103.3 
111*  -0.2 
61*  13025 

65*  08/13/1981 
113*  94.4 

111*  0.9 


I>PRINT/NAH£/N0,C65,PC,D0UC  WHERE  EHBANK-ZONE  EQ  RANCOR  1 

1>AND  C65  EQ  08/13/1981) 

NO*  13026 

DATE-HADE*  08/13/1981 
PC*  94.9 
DOUC*  1.0 
NO*  13021 

DATE-HADE*  08/13/1981 
PC*  96.2 
DOUC*  -0.2 
NO*  13022 

DATE-HADE*  08/13/1981 
PC*  102.0 
DOUC*  -0.9 
NO*  13020 

DATE-HADE*  08/13/1981 
PC*  98.9 
DOUC*  0.5 
NO*  13023 

DATE-HADE*  08/13/1981 
PC*  98.0 
DOUC*  -0.6 
NO*  13024 

DATE-HADE*  08/13/1981 
PC*  101.6 
DOUC*  -0.8 
NO*  13027  D 
DATE-HADE*  08/13/1981 
PC*  99.5 
DOUC*  1 . 0 
NO*  13028 

DATE-HADE*  08/13/1981 
PC*  103.3 
DOUC*  -0.2 
NO*  13025 

DATE-HADE*  08/13/1981 
PC*  94.4 
DOUC*  0.9 


(Continued) 
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Table  8  (Continued) 


oust  embanic-zone, 
EMBANK-ZONE 
XXX 

X  I. C. MAIN  DAM 
X  I.C.  COFFER 
X  FILTER 
X  DRAIN 
X  RANDOM  II 
X  RANDOM  III 
X  O.U.SkG  BAK 
X  O.U. DRAIN 
X  O.U. BAK  RAD 
X  0.U.D4FH  EMB 
X  SPLU  BAK -RAD 
X  EXPLO  TESTS 
X  SPLU  DRAIN 
X  ROAD  EMB 
X  RANDOM  I 
X  DRAIN  DITCH 
X  RECORD  R-I 
X  DRAIN  DITCH 
X  RECORD  I.C. 

X  RECORD  R-I I 


OUST  N0,C6S,PC,D0UC  UHERE  EMBANK-ZONE  EO  RANDOM  I 


OAND 

C6S  EO 
NO 

08/13/E981i 

DATE-MADE 

PC 

DOUC 

XXX 

X 

13086 

08/13/1981 

94.9 

1.0 

X 

13021 

08/13/1981 

96.2 

-0.2 

X 

13022 

08/13/1981 

102.0 

-0.9 

X 

13020 

08/13/1981 

98.9 

0.5 

X 

13023 

08/13/1981 

98.0 

-0.6 

X 

13024 

08/13/1981 

101.6 

-0.8 

X 

13027 

08/13/1981 

99.5 

1.0 

X 

13028 

08/13/1981 

103.3 

-0.2 

X 

13025 

08/13/1981 

94.4 

0.9 

OUST  N0.C6S.PC  UHERE  C21  EO  RANDOM  I  AND 


I>C6S 

SPANS 

07/O1/1981X  08/01/1981 

XXX 

NO 

DATE -MADE 

PC 

X 

12861 

07/01/1981 

97.4 

X 

12866 

07/02/1981 

97.9 

X 

12869 

07/07/1981 

97.9 

X 

12873 

07/08/1981 

97.3 

X 

12879 

07/09/1981 

97.2 

X 

12886 

07/11/1981 

98.0 

X 

12887 

07/10/1981 

97,9 

X 

12902 

07/17/1981 

97.7 

X 

12912 

07/20/1981 

97.8 

X 

12932 

07/23/1981 

97.9 

X 

12934 

07/23/1981 

97.4 

X 

12942 

07/24/1981 

97,8 

X 

12941 

07/24/1981 

97,4 

X 

12961 

07/29/1981 

97.1 

PC  EO  97.X  98 


I> 
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Table  8  (Continued) 


I>U$T  NO, PC. DOUC  UHERE  C21  EQ  RANDOM  I  AND  C55  EO  20 
I>AND  (PC  N£  95.0*  99.0  OR  DOUC  NE  -1.0*  2.0); 


NO 

PC 

DOUC 

10491 

98.0 

-1.4 

10492 

99.1 

1.2 

10493 

98.4 

2.7 

10494 

104.7 

0.4 

10495 

101.2 

3.1 

10496 

93.5 

1.6 

10497 

93.1 

0.8 

10498 

83.9 

2.5 

10499 

88.9 

2.6 

10501 

103.4 

1.9 

10502 

101.1 

0.3 

10503 

100.2 

-1.1 

10504 

102.1 

-1.9 

10505 

100.2 

3.1 

10506 

103.5 

-0.2 

10507 

99.3 

1.4 

10510 

97.5 

-1.8 

10511 

95.3 

3.2 

10514 

94.2 

1.0 

10516 

92.6 

0.4 

10518 

99.6 

-1.7 

10519 

103.2 

2.8 

10520 

100.1 

0.9 

10522 

99.4 

-0.2 

10523 

98.3 

-1.6 

10525 

95.3 

2.4 

10526 

93.0 

-0.3 

10527 

88.6 

1.4 

10528 

97.5 

3.6 

10529 

97.1 

3.1 

10530 

99.1 

-0.5 

10531 

102.5 

0.0 

10533 

92.6 

5.4 

10534 

98,7 

2.4 

10536 

99.6 

0.2 

10537 

95.8 

2.4 

10539 

94.2 

-3.1 

10541 

96.1 

2.9 

10542 

86.2 

0.9 

LIST  COUNT(PC).SUH<PC)#AUG<PC),MIN<PC>.MAX<PC), SIGMA (PC) 
I>UHERE  C21  EO  RANDOM  I  AND  C5S  EO  20  AND  USE  PAILS; 


4512.200 


98.091 


92.600 


I>DITTO  UHERE  C21  EQ  RANDOM  I  AND  C55  EO  21  AND  USE  PAILS; 


3538.700 


98.297 


86.200 


104.700 


109.100 


(Continued) 
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Table  8  (Continued) 


DESCRIBE  C66  THRU  C7S i 

66*  TESTS  (R6  IN  46) 

61*  NO  (INTEGER  NUNBER  9(6)  IN  66) 
62*  TC  (NANE  X  IN  66) 

63*  USE  (NAME  X  IN  66) 

65*  DATE -HADE  (DATE  IN  66) 

66*  LAB  (NAME  X  IN  66) 

67*  STA  (NAME  X(6>  IN  66) 

69*  OFT  (INTEGER  NUMBER  9(5)  IN  66) 
71*  ELE  (DECIMAL  NUNBER  9999.9  IN  66) 
73*  DEP  (INTEGER  NUNBER  99  IN  66) 

75*  NS  (NAME  X<16)  IN  66) 

76*  FUD  (DECIMAL  NUNBER  999.9  IN  66) 
77*  FDD  (DECIMAL  NUNBER  999.9  IN  66) 


79*  FUC  (DECIMAL  NUMBER  99.9  IN  66) 


Table  8  (Concluded) 


DUST  NO.STA.OFT.ELE. ORDERED  BV  STA.LOU  OFT 


tt 


*E  C21 

EO  RAN DON 

I  AND  CS5 

EQ  20  j 

NO 

STA 

OFT 

ELE 

10524 

16+90 

304 

197.2 

10538 

17+04 

302 

202.3 

10526 

18+25 

256 

214.5 

10499 

18+25 

2S6 

206.0 

10503 

18+25 

256 

206.0 

10533 

18+25 

256 

214.5 

10508 

18+26 

516 

201.0 

10525 

18+35 

450 

209.7 

10517 

18+37 

310 

208.1 

10494 

18+50 

285 

202.7 

10539 

18+64 

688 

216.0 

10530 

18+65 

249 

212.0 

10513 

18+74 

736 

208.4 

10520 

18+75 

2S9 

211.6 

10507 

18+75 

259 

207.0 

10516 

18+75 

520 

208.0 

10506 

18+90 

559 

202.5 

10532 

18+90 

601 

211.1 

10521 

19+15 

265 

209.5 

10534 

19+41 

637 

210.9 

10496 

19+44 

243 

201.1 

10502 

19+44 

243 

201.0 

10531 

19+50 

132 

209.0 

10492 

19+64 

334 

202.5 

10514 

19+66 

487 

206.0 

10536 

19+70 

256 

213.4 

10491 

19+84 

220 

200.5 

10519 

20+01 

582 

210.0 

10523 

20+52 

528 

208.7 

10501 

20+66 

529 

202.0 

10495 

20+74 

279 

205.0 

10542 

20+74 

279 

217.0 

10515 

20+74 

279 

210.0 

10528 

20+74 

322 

210.0 

10518 

20+7S 

264 

208.8 

10509 

20+76 

543 

205.0 

10511 

20+76 

543 

205.0 

10527 

20+76 

543 

210.0 

10537 

20+76 

543 

213.0 

10535 

20+76 

582 

210.7 

10493 

21+00 

409 

202.0 

21+16 

196 

210.0 

li.r'l 

21+20 

280 

210.4 

10510 

21+23 

214 

206.5 

10498 

21+49 

289 

206.0 

10512 

21+49 

289 

209.0 

10540 

21+49 

289 

214.0 

10504 

21+49 

289 

206.0 

10541 

21+50 

553 

216.0 

10505 

22+00 

443 

193.5 

22+45 

225 

202.0 

22+50 

560 

202.5 

I> 


EXIT 

DEXITj 

-506-  CLOSED  SOILDB 
82/03/28.  13.14.57.  END  SVSTEN  2000 
STOP  S2K 


16  3853  82/03/22.  11.24.38. 

VERSION  3.60F 
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Report  Writer  Retrievals 


Description 

46.  After  the  user  becomes  familiar  with  the  ad  hoc  retrievals, 
there  are  many  results  or  data  groupings  the  user  would  like  to  generate. 
Using  the  procedures  in  the  previous  paragraph  would  be  cumbersome  if 
standard  commands  would  have  to  be  entered  each  time  the  same  type  of 
result  is  needed  for  a  different  group  of  data.  The  report  writer 
feature  of  the  data  base  was  designed  to  generate  frequently  used  output 
formats.  The  report  writer  will  generate  a  set  format  and  allow  the 
user  to  select  the  data  group  of  interest.  The  data  base  files  are 
scanned  once  for  each  report;  whereas,  the  files  are  scanned  for  each 
interactive  command. 

47.  Use  of  the  report  writer.  This  section  describes  the  use  of 
the  report  writer  feature  and  the  various  formats  or  reports  that  are 
available.  The  user  is  referred  to  the  System  2000  GENIUS  program 

( GET , GENI US / UN=C ECE 2K ;  GENIUS  and  USE  OPTIONS  88  and  89)  for  easy  prepa¬ 
ration  of  a  report  writer  file.  (For  GENIUS  manual,  contact  Mr.  Walter 
Hart,  DAEN-RMI,  FTS  272-0280.) 

£.  File  availability.  All  files  on  Boeing  Computer  System 
are  stored  on  disks;  thus  any  file  the  user  accesses  must 
be  put  in  the  user's  work  space.  To  put  files  in  this 
work  space,  the  computer  must  "GET"  the  files  from  the 
disk  storage.  There  are  two  methods  for  the  user  to  put 
files  in  the  work  space.  The  first  method  is  to  have 
frequently  used  files  obtained  in  the  command  file  that 
accesses  the  data  base.  This  way,  every  time  the  data 
base  is  accessed,  these  report  writer  files  are  available 
for  use.  An  example  of  this  method  is  snown  below  in  the 
listing  of  the  file  CMP: 

GET , S  2KGET/UN-C  ECELB 

GET, FDDH/UN=C ER0K2 

GET, FWCH/UN*CER0K2 

CALL, S2KGET 

S2K 

This  file  will  put  report  writer  files  FDDH,  and  FWCH  in 
the  user's  work  space  along  with  accessing  the  data  base. 
Generally  these  command  files  are  generated  for  each 
project;  however,  the  names  are  defined  by  the  users  for 
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each  project.  The  second  method  of  putting  files  in  the 
user's  work  space  is  to  issue  a  GET  command  before  the 
data  base  command  file  is  executed.  An  example  of  this 
procedure  is: 

GET,  PCH/UN=CER0K2 

GET, CMD 

CALL.CMD 

This  example  would  put  the  file  PCH  in  the  user's  work 
space  along  with  any  files  listed  in  CMD. 

_b.  Report  generation.  When  the  user  is  working  interactively 
with  the  data  base,  the  system  is  initially  reading  all 
commands  from  the  terminal  which  is  considered  INPUT.  If 
the  user  wants  to  have  the  data  base  read  commands  from  a 
file,  the  following  command  is  used: 

COMMAND  FILE  IS  (file  name); 

The  file  name  is  supplied  by  the  user  from  the  list  of 
files  available  in  the  work  space.  If  the  file  contains  a 
series  of  ad  hoc  retrieval  commands,  the  data  base  will 
execute  the  commands  in  the  order  they  appear  in  the  file. 
However,  if  the  file  is  a  report  writer  file,  the  data 
base  will  compile  the  commands  and  execute  the  report  if  a 
GENERATE  statement  is  included  in  the  file.  If  this 
statement  is  not  in  the  file,  the  user  must  enter  it  after 
the  report  is  compiled.  A  GENERATE  statement  will  select 
the  data  the  user  is  interested  in  obtaining.  It  can 
contain  a  WHERE  clause  to  select  the  data  as  illustrated 
in  the  following  example: 

GENERATE  (report  name)  WHERE  USE  FAILS  AND  C21  EQ 
RANDOM  I  AND  C55  EQ  20; 

The  report  name  is  the  name  given  to  the  report  writer 
format . 

48.  Available  report  writer  files.  The  report  writer  feature 
provides  the  user  with  the  capability  to  define  and  generate  formatted 
reports.  A  number  of  the  report  writer  files  have  been  developed  by 
CAGE  personnel  for  project  use  and  by  personnel  at  Warm  springs  Dam  for 
their  use.  Copies  of  all  files  are  stored  in  user  number  CER0K2  and  can 
be  obtained  for  use  as  illustrated  above  in  subparagraph  47ja.  The  file 
RPTWRT,  stored  in  user  number  CER0K2,  contains  a  list  of  basic  report 
writer  programs.  In  addition  to  the  listing,  a  brief  description  of 
each  file  along  with  instructions  for  using  the  report  writer  feature  is 
included.  A  listing  of  this  file  is  included  in  Appendix  A.  Additional 
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AD— (1138  SS6  GEOTECHNICAL  CONSTRUCTION  CONTROL  DATA  BASE  SYSTEM  2/2 

USER'S  HANUALCUV  ARMY  ENGINEER  WATERWAYS  EXPERIMENT 
STATION  VICKSBURG  MS  GEOTECHNICAL  LAB  E  V  EDRIS  ET  AL. 
UNCLASSIFIED  APR  83  WES/IR/GL-83-1  F/G  12/2  NL 


■ 

i 

report  writer  program  files  are  described  in  Appendix  B.  The  following 
commands  are  used  to  obtain  a  listing  of  file  RPTWRT: 

C>GET,  RPTWRT/UNC  ER0K  2 

OLIST 

The  available  report  writer  files  are  described  below  with  some  example 
formats  shown. 

a^.  SUMDAY .  This  report  writer  file,  written  by  Warm  Springs 
Dam  personnel,  compiles  a  daily  summary  of  field  testing 
results.  Contained  in  this  report  are  the  location  and 
identification  data,  comments,  a  limited  summary  of  clas¬ 
sification  data,  and  a  complete  summary  of  results  from 
moisture  and  compaction  tests  for  each  field  test.  Values 
from  the  rapid  1-point  test  are  printed  on  the  first  line, 
with  final  oven-dry  values  from  the  1-point  test  printed 
on  the  second  line.  Values  from  5-point  testing,  where 
available,  are  printed  on  the  third  line.  This  report 
writer,  as  shown  in  Figure  9,  is  designed  to  provide  a 
complete  summary  of  compaction  and  moisture  results  on  a 
test-by-test  basis.  There  is  no  internal  restriction  on 
the  generation  of  this  report  writer;  this  allows  the  user 
maximum  flexibility  in  tailoring  the  output  to  his  needs. 
The  absence  of  any  internal  restrictions  on  generation  of 
the  report  writer  requires  a  restricting  WHERE  clause  be 
included  in  the  GENERATE  statement.  A  normal  restriction 
would  include  Embankment  Zone  and  Report  Number  in  the 
WHERE  statement.  Although  any  KEY  element  can  be  included 
in  the  WHERE  clause,  it  is  generally  more  efficient  (and 
less  expensive)  to  use  components  associated  with  the 
higher  order  repeating  groups  (C20,C40)  when  possible. 
Examples  of  commands  used  with  this  report  writer  follow: 

COMMAND  FILE  IS  SUMDAY; 

GENERATE  SUMDAY  WHERE  C21  EQ  RANDOM  I  AND  C55  EQ  56; 

The  following  GENERATE  commands  are  additional  examples: 

GENERATE  SUMDAY  WHERE  C21  EQ  I. C. MAIN  DAM  AND  C55 

GE  24  AND  C55  LE  26  OR  C21  EQ  RANDOM  II  AND  C55  EQ  6; 

GENERATE  SUMDAY  WHERE  C21  EQ  RANDOM  I  AND  C65 
EQ  10/06/1980' 

GENERATE  SUMDAY  WHERE  C21  EQ  RANDOM  I  AND  NO  EQ 
11000*11010; 

J>.  Histogram  report  writers.  There  are  six  report  writer 

files  that  generate  histogram  tables  that  can  be  used  with 
a  graphic  program  that  will  be  described  later  in  this 


Part  to  generate  histograms.  These  files  DOWCH,  PCH, 

FDDH,  FWCH,  GR2H,  and  PIH  produce  the  histogram  tables  for 
the  deviation  from  optimum  water  content,  percent  compac¬ 
tion,  field  dry  density,  field  water  content,  percent 
passing  the  No.  200  sieve,  and  plastic  index,  respectively 
The  tables  include  the  percent  for  each  interval,  the 
number  of  tests  in  each  interval,  the  overall  average  for 
each  embankment  zone,  and  the  total  number  of  tests  for 
each  embankment  zone.  Each  of  these  report  writers  allows 
the  user  to  specify  the  embankment  zone,  report  period, 
tests  for  which  USE  fails,  or  any  other  data  selecting 
parameter  in  the  GENERATE  statement.  The  report  names  for 
these  files  are  OWC  for  file  DOWCH,  PC  for  PCH,  MDD  for 
FDDH,  WC  for  FWCH,  GR2  for  GR2H,  and  PI  for  PIH. 

The  DOWCH  report  writer  produces  a  histogram  table  that 
groups  the  data  into  1  percent  Intervals  within  a  range  of 
-5  to  +5  percent.  In  addition,  the  percent  of  the  tests 
outside  the  range  of  -1  to  +2  percent  is  determined.  An 
example  of  the  output  from  this  file  is  shown  in 
Figure  10,  which  was  generated  for  all  embankment  zones 
using  the  following  commands: 

COMMAND  FILE  IS  DOWCH; 

GENERATE  OWC  WHERE  USE  FAILS  AND  C65  GT  06/01/1980; 

The  PCH  file  produces  the  histogram  table  shown  in 
Figure  11.  This  table  has  data  Intervals  of  1  percent 
with  a  range  of  90  to  105  percent  compaction.  The  tests 
that  fall  below  93  percent  and  95  percent  are  grouped 
together  in  a  column  separate  from  the  individual  data 
intervals.  Figure  11  was  generated  with  the  following 
commands : 

COMMAND  FILE  IS  PCH; 

GENERATE  PC  WHERE  USE  FAILS  AND  C65  GT  08/01/1980; 

The  FDDH  report  writer  produces  a  histogram  table  that 
groups  the  data  into  5  pcf  intervals  starting  at  110  pcf 
and  continuing  to  140  pcf.  An  example  of  the  output  from 
this  file  is  shown  in  Figure  12,  which  was  generated  for 
the  Impervious  core  of  the  main  dam.  Random  I  and 
Random  II,  with  the  following  commands: 

COMMAND  FILE  IS  FDDH; 

GENERATE  MDD  WHERE  USE  FAILS  AND  C65  EQ  01/01/1980  AND 
C21  EQ  I.C.  MAIN  DAM  OR  C21  EQ  RANDOM  I  OR  C21  EQ 
RANDCM  II; 

The  FWCH  files  produce  the  histogram  table  shown  in 
Figure  13.  This  table  has  data  Intervals  of  2  percent 
with  a  range  of  2  to  16  percent.  The  commands  used  to 
generate  this  table  for  all  embankment  zones  are: 


COMMAND  FILE  IS  FWCH; 

GENERAL  WC  WHERE  USE  FAILS  AND  C65  GT  01/01/1980; 

The  GR2H  report  writer  produces  a  histogram  table  that 
groups  the  data  Into  5-percent  Intervals  ranging  from  0  to 
50  percent.  The  PIH  file  generates  a  histogram  table  with 
data  Intervals  of  5  percent  and  a  range  of  0  to  30  percent 
The  commands  to  generate  these  two  tables  are  the  same  as 
the  above  examples  with  the  field  and  report  names  changed 
accordingly. 

Summary  result  reports.  These  report  writer  files  were 
written  by  Warm  Springs  Dam  personnel  for  use  with  their 
data  base  system: 

(1)  SUMREPT.  This  report  writer  file  is  designed  to 
summarize  final  testing  results  for  a  selected  zone  and 
report  period.  The  file  compiles  a  ranking  of  percent 
compaction,  percent  deviation  from  optimum  moisture,  and  a 
summary  of  testing  organized  by  lab  and  test  type.  The 
ranking  of  both  percent  compaction  and  deviation  from 
optimum  moisture  are  incremented  in  steps  of  1  percent. 

The  average  value  of  percent  compaction  and  deviation  are 
given  along  with  the  number  of  tests  included  in  the 
summary.  A  quick  reference  of  the  percentage  of  passing 
and  falling  tests  is  provided  for  both  the  compaction  and 
moisture  specifications.  Figure  14  is  an  example  of  the 
report  generated  by  this  file.  The  output  of  this  report 
writer  is  ordered  by  Embankment  Zone  (C21)  and  Report 
Number  (C55).  A  change  in  either  the  embankment  zone  or 
report  number  during  the  execution  of  the  report  writer 
will  cause  the  output  to  skip  to  a  new  page.  This  file  is 
internally  restricted  to  tests  for  which  USE  (C63)  falls, 
i.e.,  only  tests  which  are  neither  voided  or  retested  by  a 
subsequent  test  are  considered.  The  component  USE  (C63) 
allows  elimination  of  voided  tests  from  statistical 
consideration.  This  report  writer  is  specifically  de¬ 
signed  to  summarize  testing  results  by  report  period.  Any 
combination  of  embankment  zone  or  report  period  may  be 
listed  in  the  WHERE  cle  .'e  when  generating  this  report 
writer.  The  report  wri‘.  «r  cannot  combine  data  from  dif¬ 
ferent  zones  or  different  report  periods.  Proper  use  of 
this  report  writer  requires  specification  of  Bnbankment 
Zone  (C21) ,  Report  Number  (C55),  Begin  Date  (C41),  or  End 
Date  (C43)  in  the  WHERE  clause.  Examples  of  commands  used 
with  this  report  writer  are: 

COMMAND  FILE  IS  SUMREPT; 

GENERATE  SUMREPT  WHERE  C21  EQ  RANDOM  I  AND  C55  EQ  43; 

The  following  commands  are  additional  examples  of  GENERATE 
statements  that  can  be  used  with  this  report  writer: 


CENERATE  SUMREPT  WHERE  C21  EQ  RANDOM  I  AND  C55  GE  48 
OR  C55  LE  52; 

GENERATE  SUMREPT  WHERE  C21  EQ  RANDOM  I  AND  C55  EQ  37 
OR  C21  EQ  RANDOM  II  AND  C55  EQ  18; 

GENERATE  SUMREPT  WHERE  C41  EQ  06/10/1980; 

(2)  SUMCMP.  This  report  writer  file  contains  just  the 
percent  compaction  summary  of  SUMREPT.  An  example  is 
presented  in  Figure  15. 

(3)  SUMCMPX.  This  file  is  the  same  as  SUMCMP  but  is  not 
ordered  by  report  periods. 

(4)  SUMDEV.  This  report  writer  file  contains  just  the 
deviation  from  optimum  water  content  portion  of  SUMREPT. 

An  example  is  presented  in  Figure  16. 

(5)  SUMDEVX,  This  file  is  the  same  as  SUMDEV  but  the 
report  periods  are  not  ordered. 

(6)  SUMSUM.  This  report  combines  SUMCMP  and  SUMDEV  along 
with  providing  information  about  tests  that  fail  to  meet 
the  specifications.  Tests  that  have  been  retested  or 
voided  tests  (USE  exists)  are  not  included.  An  example  of 
the  report  is  shown  in  Figure  17. 

(7)  SUMLABD.  This  file  summarizes  the  total  number  of 
tests  that  were  taken  along  with  how  many  1-point  and 
5-point  tests  there  were.  The  number  of  tests  each  lab 
performs  are  also  included.  The  table  is  generated  for 
each  date  a  test  was  run  and  each  embankment  zone  as 
Figure  18  illustrates. 

(8)  SUMIABW.  This  report  is  similar  to  SUMLABD  except 
the  report  is  generated  on  the  basis  of  each  report  period 
and  embankment  zone.  Figure  19  shows  an  example  of  this 
report . 

Classification  summary  reports.  This  series  of  report 
writers  file,  written  by  Warm  Springs  Dam  personnel,  is 
designed  to  generate  tables  that  summarize  the  classifi¬ 
cation  data  for  the  5-point  soil  testing.  These  report 
writers  include  the  data  for  U.  S.  Geological  Survey  Soil 
Classification,  specific  gravity  values,  borrow  source, 
Atterberg  limits,  the  full  gradation,  test  identification, 
maximum  density,  and  optimum  moisture  content.  This 
series  of  report  writers  demonstrates  the  flexibility  of 
System  2000.  By  making  simple  changes  in  the  statement 
ORDERED  BY  in  the  report  writer  file  the  output  can  be 
rapidly  adjusted  to  emphasize  the  components  required  by 
the  user.  The  output  in  each  case  is  similar  in  appear¬ 
ance;  the  test  data  presented  rnd  the  order  in  which  the 
data  appear  are  varl  i.  GENEp  !E  statements  typically 
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Example  of  table  from  report  writer  file  SUMDEV 
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Figure  19.  Example  of  table  from  report  writer  file 


restrict  the  data  by  zone  and  report  number  for  SUM5PT; 
the  other  report  writers  will  restrict  the  execution  by 
zone  and  report  period  (SUM200),  or  report  period  and 
borrow  source  (SUMBOR,  SBR200,  SUMFOC) . 

(1)  SUM5PT,  This  report  writer  summarizes  the  5-point 
testing  by  report  period  and  test  number.  It  provides 
access  to  tests  taken  during  a  specific  report  period  or 
to  a  single  test.  Figure  20  shows  an  example  of  the 
output  for  one  report  period. 

(2)  SUM200,  This  file  considers  all  5-point  tests  and 
places  these  tests  in  order  from  fine  to  coarse  using  the 
sieve  data  for  sieves  No.  200,  100,  40,  and  16.  An  exam¬ 
ple  of  the  output  from  this  file  is  shown  in  Figure  21. 

(3)  SUMBOR.  The  5-point  data  are  summarized  by  borrow 
area  and  data  in  this  report  writer. 

(4)  SBR200.  This  file  combines  report  writer  file  SUM200 
and  SUMBOR. 

(5)  SUMFOC.  This  report  writer  is  initially  ordered  by 
material  source  then  by  maximum  dry  density  and  optimum 
water  content. 

SUMSUPP.  This  report  writer,  written  by  Warm  Springs  Dam 
personnel,  compiles  the  supplementary  mechanical  analysis 
summary  which  is  submitted  with  Big  Form  4080  for  DRAIN 
Material  and  FILTER  Material.  The  data  Included  in  this 
report  are  test  number,  location,  full  sieve  analysis,  and 
the  average  specific  gravity.  This  file  is  not  internally 
restricted.  The  summary  generated  will  Include  values  for 
all  tests.  The  report  writer  is  specifically  designed  to 
summarize  the  test  results  by  report  period,  as  shown  in 
Figure  22.  Any  combination  of  embankment  zone  or  report 
period  can  be  listed  in  the  WHERE  clause  when  generating 
the  report.  All  data  are  listed  on  a  test-by-test  basis. 
Proper  use  of  this  report  writer  requires  specification  of 
Bnbankment  Zone,  Report  Number,  Begin  Date,  or  End  Date  in 
the  WHERE  clause.  Examples  of  commands  used  with  this 
report  writer  follow: 

COMMAND  FILE  IS  SUMSUPP; 

GENERATE  SUMSUPP  WHERE  C21  EQ  DRAIN  AND  C55  EQ  45; 

The  following  commands  are  additional  examples  of  GENERATE 
statements  that  can  be  used  with  this  report  writer: 

GENERATE  SUMSUPP  WHERE  C21  EQ  FILTER  AND  C43 
EQ  04/18/1979; 

GENERATE  SUMSUPP  WHERE  C21  EQ  DRAIN  AND  C55  EQ  21  OR 
C21  EQ  FILTER  AND  C55  GE  21  AND  C55  LE  24; 
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WEEKS.  This  report  writer  computes  the  report  average  and 
cumulative  average  for  the  percent  compaction,  deviation 
from  optimum  water  content,  maximum  dry  density,  optimum 
water  content,  field  dry  density,  and  field  water  content. 
The  report  number,  beginning  date,  and  end  date  along  with 
the  number  of  tests  included  in  the  average  are  included 
in  the  table  as  shown  in  Figure  23.  The  cumulative  aver¬ 
age  starts  with  the  first  report  period  specified  in  the 
GENERATE  statement.  Thus  if  only  one  report  period  is 
requested,  the  report  and  cumulative  averages  will  be  the 
same. 

The  report  writer  is  not  internally  restricted,  thus  the 
report  generated  will  Include  values  for  all  tests  unless 
the  WHERE  clause  is  restrictive  in  selecting  the  data 
group.  Proper  use  of  this  report  requires  specification 
of  embankment  zone,  report  number,  and  tfiether  the  USE 
field  is  blank  in  the  WHERE  clause.  Examples  of  commands 
used  with  this  report  writer  follow: 

COMMAND  FILE  IS  WEEKS; 

GENERATE  WEEK  WHERE  C21  EQ  RANDOM  I  AND  USE  FAILS 
AND  C55  SPANS  1*10; 

(31200.  This  report  writer  generates  the  report  and  cumu¬ 
lative  average  for  the  percent  passing  the  No.  200  sieve. 
This  file  is  the  same  as  WEEKS  except  that  the  gradations 
are  averaged  Instead  of  the  other  results. 


49.  The  following  data  base  session,  shown  In  Table  9  as 
Example  6,  Illustrates  the  generation  of  report  writer  retrievals.  Four 
of  the  files  described  earlier  are  selected  for  this  session.  To  limit 
the  amount  of  output,  some  of  the  WHERE  clauses  used  in  the  GENERATE 
statements  are  more  restrictive  than  in  general  use.  The  first  two 
reports  are  generated  on  the  terminal,  while  the  last  two  reports  are 
written  to  report  files  that  are  then  listed.  The  commands  to  access 
the  data  base  have  been  put  into  file  CMD  for  this  example.  This  ses¬ 
sion  accesses  the  Warm  Springs  Dam  data  base  and  costs  about  forty-seven 
dollars.  The  third  report  alone  costs  about  twenty-two  dollars  because 
of  the  number  of  tests  and  the  calculations  involved  in  the  retrieval. 
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PLEX  Retrievals 


Description 

50.  PLEX  retrievals  use  a  FORTRAN  program  to  access  and  retrieve 
data  from  the  data  base.  This  method  allows  the  data  to  be  manipulated 
and  presented  in  ways  and  formats  that  are  permissible  in  FORTRAN  pro¬ 
grams  but  not  available  with  the  ad  hoc  or  report  writer  retrievals. 
These  programs  require  the  skill  of  a  computer  programmer  to  write  and 
are  not  transportable  from  one  data  base  to  another;  but  once  written, 
any  user  can  execute  the  program.  This  section  will  deal  with  existing 
programs;  the  user  is  referred  to  the  System  2000  PLEX  Manual  (Intel 
Systems  Corporation  1983)  for  details  on  writing  these  programs.  There 
are  three  PLEX  programs  currently  available  for  use  with  this  data  base 
system.  The  first  one,  the  interactive  data  entry  program,  has  been  de¬ 
scribed  in  Part  III.  The  other  programs  generate  the  Eng  Form  4080  and 
Eng  Form  4081,  The  Eng  Form  4080  program,  written  by  San  Francisco  Dis¬ 
trict  personnel,  generates  the  form  for  the  user-specified  embankment 
zone  and  report  period.  An  example  of  this  computer-generated  form  is 
shown  in  the  following  example.  To  execute  this  program,  the  commands 
are: 

GET,F4O8O/UN=CER0K2 
CALL, F4080 

The  Eng  Form  4081  program,  a  modified  version  of  Eng  Form  4080  program, 
generates  the  form  for  the  embankment  zone  and  report  period  specified 
by  the  user.  To  execute  this  program  the  commands  are: 

GET , F408 1 /UN-C  ER0K 2 
CALL.F4081 

Example  7 

51.  Example  7,  shown  in  Table  10,  illustrates  the  generation  of  an 
Eng  Form  4080  using  a  PLI  retrieval.  In  addition  to  executing  the  pro¬ 
gram,  the  required  information  needed  by  the  program  is  shown.  For  this 
example  explanatory  notes  are  printed  at  the  end  of  the  report.  This 
program  accesses  the  Warm  Springs  Dam  data  base  and  costs  about  thirteen 
dollars . 
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Graphic  Plots 


Description 

52.  General.  Graphic  programs  have  been  developed  for  use  with 
the  data  base  to  generate  plots.  All  of  the  programs  use  a  two-step 
process  to  generate  plots.  First,  the  data  file  or  report  file  is  gen¬ 
erated  while  the  user  is  accessing  the  data  base.  The  second  step  con¬ 
sists  of  using  the  data  file  with  the  graphic  program  to  generate  the 
plot.  Three  of  the  four  graphic  programs  were  written  for  a  specific 
type  of  plot  with  a  specific  format  for  the  data  file.  These  plots  were 
designed  for  a  132-character  line  printer,  but  can  be  used  with  any 
equipment  that  is  compatible  with  the  U.  S.  Army  Corps  of  Engineers 
Graphics  Compatibility  System  (GCS)  except  for  80-character  alphanumeric 
terminals.  The  other  program  will  plot  any  data  in  an  x-y  type  of 
format.  This  section  describes  these  four  graphic  programs  along  with 
detailing  the  requirements  of  the  input  files.  The  user  is  referred  to 
the  previous  sections  for  details  of  the  query  language  and  how  to  gen¬ 
erate  an  OUTPUT  or  REPORT  file.  The  file  GEOPLT  stored  in  user  number 
CER0K2,  contains  information  about  the  graphic  programs  currently 
available.  In  addition  to  a  brief  description  of  each  plot,  instruc¬ 
tions  for  obtaining  the  various  data  files  are  included.  A  listing  of 
this  file  is  included  in  Appendix  C.  The  following  commands  are  used  to 
obtain  a  listing  of  file  GEOPLT: 

C  GET.GEOPLT/UN-CER0K2 

C  LIST 

In  addition  to  this  file,  other  graphic  programs  are  stored  in  this  user 
number. 

53.  Shotgun  plot.  The  shotgun  plot  program  will  generate  the  plot 
shown  in  Figure  24.  In  this  figure,  the  specified  limits  are  -1  to  +2 
for  water  content  and  95  percent  for  compaction.  These  values  can  be 
varied,  with  the  limits  of  the  water  content  centered  within  its  range. 
Failing  tests,  containing  a  'U'  in  the  USE  field,  are  assigned  a  letter 
instead  of  an  asterisk.  The  comment  field  is  then  scanned  to  determine 
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the  test  number  of  the  retest  which,  when  found,  assigns  the  same  letter 
to  that  test.  With  the  letters  or  asterisks  determined  for  all  the 
tests  in  the  data  file,  the  plot  is  generated.  A  listing  of  the  data 
file,  shown  in  Figure  25,  is  printed  by  the  program  after  the  plot  is 
generated.  If  two  or  more  test  values  plot  at  the  same  point,  the 
asterisk  is  replaced  with  a  number  indicating  how  many  values  are  at 
that  point.  The  numbers  also  appear  in  the  data  list  so  that  the  user 
can  identify  which  tests  have  the  same  values.  Values  that  occur  out¬ 
side  the  plotted  range  are  located  on  the  edge  of  the  graph.  The  infor¬ 
mation  about  the  number  of  tests  on  the  right  side  of  Figure  24  is 
calculated  for  the  current  report  only.  The  user  must  write  or  type  the 
cumulative  results  on  the  plot  and  draw  the  lines  between  corresponding 
letters  to  indicate  where  the  failing  tests  were  retested. 

54.  To  generate  the  shotgun  plot,  the  user  must  generate  a  data 
file  from  the  data  base.  The  following  commands  must  be  executed  in  the 
prescribed  order  while  the  user  is  working  in  the  data  base  to  generate 
the  data  file: 

REPORT  FILE  IS  PL0T1;  (output  file  name) 

LIST  C1,C21  WHERE  C21  EQ  RANDOM  I; 

LIST  C23,C27,C29  WHERE  SAME; 

LIST  C55,C41,C43  WHERE  SAME  AND  C55  EQ  20; 

LIST  C61,C63,C113,C111,C149  WHERE  SAME; 

REPORT  FILE  IS  OUTPUT; 

The  component  numbers  have  been  defined  in  Table  1.  The  data  could  be 
grouped  by  variables  other  than  the  report  number.  Failing  tests  that 
are  retested  in  another  report  can  be  included  in  the  data  file  by  using 
the  last  LIST  command  and  specifying  the  retest  number  in  the  WHERE 
clause.  An  example  using  test  number  10542  would  be: 

LIST  C61,C63,C113,C111,C149  WHERE  NO  EQ  10549; 

The  last  command  returns  the  output  to  the  user's  terminal  for  any  other 
data  base  work.  The  REPORT  file  is  a  temporary  file  and  the  user  is 
referred  to  subparagraph  30ji  for  the  procedure  on  using  REPORT  files. 


74555 

* 

97.2 

24556 

* 

95.9 

24557 

* 

96.2 

24558 

* 

95.7 

2455? 

* 

1 00 . 5 

24560 

IJ 

A 

91.7 

24561 

* 

95 . 2 

24562 

A 

98.8 

24563 

* 

96.3 

24564 

U 

B 

94.8 

24565 

u 

c: 

95.6 

24566 

c 

101.6 

24567 

B 

99.5 

24568 

* 

98.7 

24569 

* 

96.3 

24570 

* 

99.2 

24571 

* 

98.8 

24572 

* 

97.2 

24573 

* 

93.3 

24574 

* 

97.1 

24575 

* 

100.7 

24576 

* 

98.0 

24577 

u 

D 

93.9 

24578 

* 

95 . 0 

24579 

* 

100.1 

24500 

* 

99 . 7 

24581 

* 

101,8 

24582 

* 

97.0 

24583 

D 

95.5 

24584 

* 

93.6 

24585 

* 

95.9 

24586 

u 

E 

95.9 

24587 

u 

E 

92.4 

24588 

* 

94.6 

2458? 

E 

99 . 8 

24590 

* 

97 . 8 

Figure  25.  Example  listing 


w  C-i 


1  >5 

R  (  2  4  5  4  9  >  T  N  9  T  R 1 1 M  E  N  T  C  ■•••  4 , 

.  4 

R< 24547) 

1  . 5 

NO  QUICK  RESULTS 

2.5 

NG 

n 

»  a". 

NO 

1 .8 

1.1-24562 

2,9 

NG 

2.3 

R< 24560) 

2,3 

INSTRUMENT  1-20 

1.2 

11-24 5 67 

-1.7 

IJ -24566 

.7 

R ( 24565 I  TOTAL  24  PASSE 

.  5 

R< 24564) 

.7 

NG 

1.9 

NG 

1.4 

NG 

2.0 

NG 

2.6 

NG 

1.6 

NG 

2.5 

INSTRUMENT  048 

.6 

1.5 

3,2 

NG 

NG 

IJ-  24583 

2.8 

NG 

1 . 1 

NG 

2.7 

NG 

-  .7 

NG 

1.8 

NG 

1.0 

R( 24577)  INTERFACE 

2.4 

NG 

1.2 

RIGHT  ABUTTMENT 

-1.3 

U-24587 

•1.1 

R< 24586)  U- 24589 

2.7 

NG 

-1.2 

R< 24587)  REWORKED  U 

.  4 

INSTRUMENT  041 

data  from  file  for  shotgun  plot 


To  generate  the  plot  once  the  data  file  exists,  the  following  commands 
are  used: 

GET.SG/UNCER0K2 
CALL , SG 

This  will  begin  execution  of  the  program.  The  system  will  ask  the  user 
the  following  questions: 

DEVICE  - 

NAME  OF  DATA  FILE 

The  user  answers  the  first  question  with  the  appropriate  response  from 
the  following  list  of  devices : 

PTK  FOR  132  'COLUMN  TTY's 
TEK  FOR  4012 
T27  FOR  4027 
TK4  FOR  4014 

T62  FOR  TEKTRONIX  4014 /TEKTRONIX  4662  (HEX  SETTING  -  0,3, 2, 3) 

DR4  FOR  4014/CALC 0MP  PLOTTING 

RJE  FOR  REMOTE  CALC0MP  PLOTTING (TAPE9 9) 

C93  FOR  BOEING  CALC0MP  PLOTTING (TAPE9 9) 

The  report  file  name  is  entered  for  the  data  file.  This  program  was 
designed  for  a  132-character  line  printer,  thus  the  graph  produced  on 
other  devices  may  not  be  presented  as  well  as  expected.  This  program 
will  not  work  on  an  alphanumeric  device  which  contains  80  characters  per 
line. 

55.  Histogram  plot.  This  program  will  generate  histogram  plots 
for  the  percent  compaction,  deviation  from  optimum  water  content,  field 
dry  density,  field  water  content,  percent  passing  No.  200  sieve,  and 
plastic  index.  The  program  is  very  versatile  in  that  it  allows  the  user 
the  following  options  while  working  interactively  with  the  program: 


KEY  -  PROGRAM  OPTION 

1  PRINT  LIST  OF  OPTIONS 

2  SELECT  NEW  DATA  FILE 

3  SELECT  A  ZONE 

4  ECHO  PRINT  INPUT 

5*  PRINT  SIMPLE  STATISTICS 

6  PLOT  A  BAR  GRAPH 

7*  PLOT  BAR  GRAPH  WITH  NORMAL  CURVE 

8  TERMINATE  RUN 

N*  THESE  ITEMS  NOT  AVAILABLE  AT  THIS  TIME 

The  user  can  work  with  any  number  of  data  files  and  can  plot  any  number 
of  embankment  zones  from  each  file.  Once  the  data  file  is  specified, 
the  computer  will  list  the  embankment  zones  and  the  total  number  of 
tests  for  each  zone  in  the  file.  The  user  chooses  the  embankment  zone 
and  then  either  lists  or  plots  the  data  (options  4  and  6).  The  simple 
statistics  and  graph  with  normal  curve  (options  5  and  7)  are  not  avail¬ 
able  at  this  time.  An  example  of  a  histogram  plot  that  is  produced  with 
this  program  is  shown  in  Figure  26.  In  this  figure,  the  vertical  scale 
ranges  from  0  to  50  percent;  however,  if  one  data  interval  is  about 
50  percent,  the  scale  will  range  from  0  to  100  percent.  The  percent  of 
tests  within  each  data  interval  is  listed  at  the  top  of  each  bar.  The 
total  number  of  tests  and  the  overall  average  are  listed  on  the  bottom 
right-hand  corner  of  the  plot. 

56.  To  use  this  graphic  program,  a  data  file  must  be  generated 
from  the  data  base.  The  six  histogram  report  writer  files  described 
earlier  are  used  to  generate  the  data  files  necessary  to  interface  with 
this  graphic  program.  The  user  is  referred  to  the  section  on  report 
files  and  report  writer  retrievals  presented  earlier  in  this  Part  for 
details  and  instructions  on  generating  the  data  files.  To  generate  the 
plot  once  the  data  file  exists,  the  following  commands  are  used: 

GET.HG/UN-CER0K2 

CALL.HG 


The  last  command  will  cause  execution  of  the  program.  The  system  will 
ask  the  same  two  questions  about  the  device  and  data  file  name  that  were 
described  for  the  shotgun  plot.  The  device  answer  is  the  same  as  was 
described  earlier.  The  data  file  name  is  the  first  file  the  user  plans 
to  use.  The  program  will  print  the  zones  and  tests  for  that  file.  The 
user  will  then  be  asked  to  select  a  zone  after  which  the  program  options 
will  be  listed.  By  selecting  options,  the  user  can  continue  using  the 
program. 

57.  Generalized  x-y  plot.  This  plot  program  was  developed  to  plot 
any  data  in  an  x-y  format  as  illustrated  in  Figure  27.  Any  data  file 
that  contains  columns  of  data  can  be  used  with  this  program.  The  user 
selects  the  options  from  those  listed  below  to  generate  a  plot. 

OPTION  _ DESCRIPTION _ 

1  NAME  INPUT  DATA  FILE 

2  READ  LABELS  FROM  FILE 

3  INPUT  LABELS  FROM  THE  TERMINAL 

4  STANDARD  SCALE 

5  INPUT  SCALE  FROM  THE  TERMINAL 

6  LINE  ADDED  TO  PLOT 

7  PLOT  DATA 

8  TERMINATE  PROGRAM  (STOP) 

Options  1  and  7  must  be  selected  to  generate  a  plot  along  with  either 
option  4  or  5.  If  titles  and  labels  are  required,  then  options  2  or  3 
must  be  selected.  The  options  can  be  selected  one  by  one  or  several  at 
a  time.  In  addition  to  selecting  ♦■he  data  file  name,  the  first  option 
determines  which  data  will  be  plotted.  This  option  will  print  the  data 
file  line  by  line  until  the  user  indicates  that  the  first  line  of  the 
x-axis  data  has  been  encountered.  At  this  point,  the  user  is  asked  for 
the  column  number  at  the  beginning  of  the  data  along  with  the  size  of 
the  data.  The  user  then  indicates  how  many  curves  will  be  plotted  along 
the  x-axis.  The  y-axis  data,  which  could  be  located  in  a  different  data 
file  than  the  x-axis,  is  then  located  by  the  same  method  that  for  the 
x-axis  data.  By  using  this  method,  data  that  are  located  in  various 
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columns  can  be  selected  (i.e.,  plot  data  in  column  6  versus  column  2). 
The  last  question  this  option  asks  the  user  is  whether  the  data  points 
should  be  connected  with  a  line.  Both  the  second  and  third  options  will 
read  three  lines  of  data  up  to  23  characters  each  for  the  title  and  x 
and  y  axis  labels.  The  second  option  will  read  from  a  user-specified 
data  file,  while  the  third  option  will  prompt  the  user  for  the 
information.  The  standard  scale,  option  4,  will  use  the  minimum  data 
value  to  establish  the  lower  end  of  the  scale  and  then  increment  the 
scale  by  an  interval  which  is  determined  from  the  range  of  the  data.  If 
the  user  does  not  like  the  standard  scale,  option  5  can  be  used  to  set 
the  scale.  This  option  can  be  used  to  window  in  on  a  portion  of  the 
data.  Option  6  allows  up  to  four  lines  to  be  added  to  the  plot  (i.e., 

45  deg  line,  or  vertical  and  horizontal  specification  boundaries).  The 
last  two  options  are  self-explanatory.  Once  the  data  have  been  defined, 
the  user  can  go  through  the  options  in  any  order.  Thus,  an  initial  plot 
with  the  standard  scale  could  be  generated;  then  the  user  could  modify 
the  scale,  add  lines,  and  replot. 

58.  The  data  files  for  use  with  this  plot  program  can  contain  any 
number  of  data  columns  and  heading  information.  These  files  will  usu¬ 
ally  be  generated  in  the  data  base  by  using  the  REPORT  File  and  LIST 
commands.  The  only  data  restriction  for  this  plot  program  is  that  only 
numeric  values  can  be  plotted. 

59.  There  are  two  versions  of  the  generalized  plot  program  that 
are  available.  The  version  that  should  be  used  will  depend  on  the  type 
of  device  on  which  the  plots  will  be  generated.  TVo  programs  are  re¬ 
quired  because  one  of  the  programs  that  interacts  with  the  user  and  the 
Corps  GCS  System  cannot  communicate  with  a  132-character  line  printer 
without  special  key  options  in  the  GCS  being  set  up  within  the  program. 
Thus,  there  is  a  version  that  must  be  used  with  a  132-character  line 
printer  and  another  version  for  any  other  device.  To  generate  a  plot  on 
a  132-character  printer,  the  following  commands  are  used: 

GET,  GENPLT/UNCER0K  2 

CALL.GENPLT 
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For  any  other  device,  the  following  commands  are  used: 

GET, GENPLOT/UN-CER0K 2 

CALL.GENPLOT 

These  commands  will  begin  execution  of  the  program.  The  system  will  ask 
the  user  for  the  type  of  device.  The  acceptable  responses  have  been 
described  for  the  shotgun  plot.  After  the  device  response,  the  program 
begins  by  asking  the  user  to  select  the  various  options. 

60.  Quick  versus  oven-dried  results.  This  graphic  program  will 
generate  the  plots  shown  in  Figures  28  and  29.  The  first  plot  is  the 
quick  versus  oven-dried  field  water  contents,  while  the  second  plot  is 
the  quick  versus  oven-dried  1-point  water  contents.  The  user  has  to  add 
the  45-deg  reference  line.  This  program  was  written  by  P.  Park  at  WES 
for  a  line  printer  before  the  generalized  x-y  plot  program.  The  axes 
are  designed  to  plot  data  with  water  contents  below  14  percent.  The 
same  plots  can  be  generated  with  the  x-y  plot  program.  However,  the 
user  does  not  have  to  answer  the  questions  in  the  quick  versus  oven- 
dried  program,  but  the  data  may  not  fit  the  scales  built  into  this  plot. 

61.  In  order  to  generate  these  plots,  the  user  must  first  generate 
a  data  file  from  the  data  base.  The  following  commands  must  be  used  in 
the  prescribed  order  to  generate  the  file: 

REPORT  FILE  IS  PLOT 2;  (output  file  name) 

LIST  C21,C55,C41,C43  WHERE  C21  EQ  RANDOM  I  AND  C55  EQ20; 

LIST  NO , QFWC ,FWC,Q1WC,WC1  WHERE  SAME  AND  USE  FAILS; 

REPORT  FILE  IS  OUTPUT; 

The  component  numbers  and  element  names  have  been  defined  in  Table  1. 

The  data  could  be  grouped  by  any  valid  WHERE  clause  as  described  in  the 
Ad  Hoc  Retrieval  section.  As  mentioned  previously,  the  REPORT  file  must 
be  SAVED  after  the  user  has  completed  the  data  base  session  to  be  a 
permanent  file.  To  generate  the  graphs,  the  following  commands  are 
used : 

GET, QFW/UN-CER0K2 

CALL , QFW 
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Figure  28.  Example  of  quick  versus  oven-dried  plot  for  field  water  content 


Figure  29.  Example  of  quick  versus  oven-dried  plot  for  one-point  water  content 


The  last  command  will  begin  execution  of  the  program.  The  system  will 
ask  the  same  two  questions  about  the  device  and  data  file  name  as  were 
asked  for  the  shotgun  plot.  The  answers  described  for  that  program  are 
valid  for  this  program. 

Example  8 

62.  Each  of  the  graphic  programs  are  illustrated  in  Table  11  as 
Example  8.  This  example  begins  with  a  data  base  session  to  generate  the 
four  report  files  that  will  be  plotted.  The  Richard  B.  Russell  Dam  data 
base  is  accessed  to  generate  the  first  three  report  files.  The  Warm 
Springs  Dam  data  base  is  used  for  the  last  report  file  because  the  other 
data  base  does  not  contain  the  1-point  water  content  results.  The  costs 
for  the  data  base  session  is  about  ten  dollars,  while  the  costs  for  the 


graphic  programs  are  about  four  to  five  dollars  each. 
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NO  ERRORS  HAVE  OCCURRED 
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APPENDIX  A:  LISTING  OF  FILE  RPTWRT,  A  SUMMARY  OF  BASIC 
REPORT  WRITER  PROGRAM  FILES 


*****  CORPS  Of  ENGINEERS  ***** 

****  GEOTECHNICAL  CONSTRUCTION  CONTROL  DATA  RASE  **** 
n»*  REPORT  UR  ITER  PROGRAMS  ***** 


LATEST  UPDATE »  9  JAN  81 


THE  FOLLOWING  REPORT  WRITER  PROGRAMS  ARE  AVAILABLE  FOR  USE 
UITH  THE  GEOTECHNICAL  CONSTRUCTION  CONTROL  DATA  BASE  SVSTEM. 


FILE 

NAME 

REPORT 

NAME 

DESCRIPTION 

THE  FOLLOWING  FILES  GENERATE  HISTOGRRAM 
TABUS  FOR  SPECIFIED  EMBANKMENT  ZONES  AND 

AND  REPORT  PERIODS.  THE  TABLES  CONTAIN 

BOTH  THE  PERCENT  AND  NUMBER  OF  TESTS 

IN  EACH  INTERUAL. 

DOUCH 

PCH 

FDDH 

FUCH 

GR2H 

PIH 

owe 

PC 

HOD 

JC 

GR3 

PI 

DEVIATION  FROM  OPTIMUM  WATER  CONTENT 

PERCENT  COMPACTION 

FIELD  DRV  DENS I TV 

FIELD  WATER  CONTENT 

PERCENT  PASSING  *200  SIEVE 

PLASTIC  INDEX 

WEEKS 

WEEK 

GENERATES  BV  SPECIFIED  EMBANKMENT  ZONE 

AND  REPORT  PERIOD  THE  REPORT  AND 

CUMULATIVE  AVERAGES  (FROM  THE  BEGINNING 

OF  THE  REQUEST )  FOR  PERCENT  COMPACTION, 

DEV.  FROM  OPTIMUM,  MAX.  DRV  DENSITV. 

AND  FIELD  WATER  CONTENT 

GR2O0 

SGR29Q 

GENERATES  THE  REPORT  AND  CUMULATIVE 

AVERAGES  (FROM  THE  BEGINNING  OF  THE  REQUEST) 
OF  THE  PERCENT  PASSING  *290  SIEVE  FOR 

ANY  EMBANKMENT  ZONE  AND  REPORT  PERIOD. 

HCIC 

MCOMPIC 

GENERATES  THE  REPORT  AND  CUMULATIVE 
AVERAGES  (FROM  THE  BEGINNING  OF  THE  REQUEST) 
FOR  THE  IMPERVIOUS  ZONE  TESTS  THAT  HAVE 

USS  THAN  2SX  PASSING  *2QQ  SIEVE. 

NCR  I 

MCOMPRI 

GENERATES  THE  REPORT  AND  CUMULATIVE 
AVERAGES  (FROM  THE  BEGINNING  OF  THE 

Shown  in  FiguAZ  A  7  cu>  an  example  on  how  to  execute  a 
nzponX  wfUteA  pAogAam. 


A2 


REQUEST  >  FOR  THE  RANDOM  I  ZONE  TESTS 
THAT  HAWE  MORE  THAN  SO*  PASSING  0206  S1EUE 


SUNDAY 

SUNDAY 

GENERATES  A  SUMMARY  OF  THE  SPECIFIED 
TESTS. 

SUNLARD 

SUNLARD 

GENERATES  A  TABLE  SHOWING  WHICH 

LAB  (OC  OR  QA  >  DID  THE  SOIL  TESTING  FOR 
EACH  REQUESTED  DATE 

SUNLABW 

SUNLABW 

GENERATES  A  TABLE  SHOWING  WHICH 

LAB<OC  OR  QA)  DID  THE  SOIL  TESTING  FOR 
EACH  REQESTED  REPORT  PERIOD. 

SUH20O 

SUH200 

LISTS  THE  5-PT  DATA  ORDERED  BY,  LOU  TO 
HIGH  ACCORDING  TO  THE  B200,  <100,  #40. 
AND  <l£  GRADATIONS. 

SUH5PT 

5UM5PT 

LISTS  THE  S-PT  DATA  IN  NUMERICAL 
SEQUENCE  OF  THE  CURUE  NUMBER. 

TO  USE  THESE  REPORT  WRITER  PROGRAMS  THE  FOLLOWING  COMMANDS  ARE 
USED  BEFORE  ENTERING  THE  DATA  BASE. 

C  GET . XXXXXXXsUN • CER0K2 

UHERE  THE  'X'S  REPRESENT  THE  FILE  NAME  OF  THE  REPORT. 

NOTE-1)  THE  'C'  AND  'I'  ARE  COMPUTER  PROMPTS. 

2)  THE  VUN-CER0K2'  IS  NOT  NECESSARY  IF  THE  FILE  RESIDES  IN  THE 
LOCAL  USERID. 


ONCE  THE  USER  IS  USING  THE  DATA  BASE, THE  REPORT  WRITER  IS  tXCUTED 
WITH  THE  FOLLOWING  COWHAND . 

I  COMMAND  FILE  IS  XXXXXXX; 

UHERE  THE  'X'S  REPRESENT  THE  FILE  NAME  OF  THE  REPORT. 

THE  COMPUTER  WILL  STATE  THAT  NO  ERRORS  HAVE  OCCURED.  IF  THERE  IS  A 
GENERATE  STATEMENT  IN  THE  FILE, THE  SELECTED  REPEATING  GROUP  WILL  BE 
IDENTIFIED.  IF  THIS  DOES  NOT  OCCUR  THE  FOLLOWING  STATEMENT  IS  NEEDED. 

I  GENERATE  VYYVYY  WHERE  USE  FAILS  < AND  ANY  OTHER  WHERE  CLAUSE); 

UHERE  THE  'V'S  REPRESENT  THE  REPORT  NAME. 

NOTE -ANY  ACCEPTABLE  WHERE  CLAUSE  HAY  BE  USED. 


IF  THF  USER  WWTS  THE  REPORT  SALCD  OH  AH  OUTPUT  FILE, THE  FOLLOWING 
COMMAND  IS  USED  BEFORE  THE  COMMAND  FILE  STATEMENT. 

I  REPORT  FILE  IS  ZZZZZZ, 

WHERE  THE  'Z'S  REPRESENT  THE  OUTPUT  FILE  NANE. 

NOTE-AFTER  THE  USER  IS  OUT  OF  THE  DATA  BASE. THESE  FILES  HEED  TO 
BE  SAUCD.  ALL  THAT  IS  NEEDED  IS  TO  SAV  ' SAUE . ZZZZZZ ' . 

EXAMPLE  t 


THE  FOLLOWING  EXAMPLE  ILLUSTRATES  THE  DESCRIBED  PROCEDURE. 

C  GET.FDDH/UN-CERBK2  (BEFORE  USING  THE  DATA  BASE) 

I  REPORT  FILE  IS  HITlj  (AFTER  THE  USER  IS  IN  THE  DATA  BASE) 

I  COMMAND  FILE  IS  FDDHj 

COMPUTER  WILL  RESPOND  UITH  'NO  ERRORS  HAUE  OCCURED' 

I  GENERATE  MOD  WERE  USE  FAILS, (IF  THERE  IS  NOT  A  GENERATE  STATEMENT 
IN  THE  REPORT  FILE) 

COMPUTER  UILL  RESPOND  UITH  '-SELECTED  RG  IS  60'  (NOTE  IF  THE  GENERATE 
STATEMENT  IS  IN  THE  REPORT  FILE, THAT  STATEMENT  UILL  BE  PRINTED 
UHEN  THE  REPORT  IS  COMPLETE. 

C  SAUE.HITl  (AFTER  THE  USER  IS  OUT  OF  THE  DATA  BASE) 
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Figure  Al.  Example  of  table  from  report  writer  file  FDDH 
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Figure  Bl.  Example  of  table  from  report  writer  file  SFDDH 
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Figure  B2.  Example  of  table  from  report  writer  file  WFWCH 


Example  of  table  from  report  writer  file  SUMRIC 


Table  B1 

Description  of  Additional  Report  Writer  Files 


Report  Writer 
File  Name 

SUM5200 

SUM5MCL 

SUM5MCI 

SUM5B0R 

SUMTOTX 

SUMTOT 

SUMRMST 

SUMODEV 

SUMRDEN 

SUMOCMP 

SUMFMST 

SUMFDEN 


_ Description _ 

Summary  of  5-point  compaction  test  with  the  results  or¬ 
dered  by  'Material  Source,'  GR200,  GR100,  GR40,  and 
GR16.  A  record  is  selected  if  GR200  exists.  File 
SUM200  is  the  same  except  the  record  is  selected  if 
CNO  exists. 

Summary  of  embankment  testing  showing  location  and 
results.  A  record  is  selected  if  USE  exists. 

Summary  of  instrument  pad  testing  showing  location  and 
results.  A  record  is  selected  if  PAD  exists. 

Summary  of  five-point  compaction  tests  ordered  by  borrow 
source,  maximum  dry  density  and  optimum  water  content. 

A  record  is  selected  if  CNO  exists. 

Summary  of  embankment  testing,  similar  to  SUMSUM  which 
is  in  the  User's  Manual.  A  record  is  selected  if  NO 
exists. 

Summary  of  embankment  testing.  A  record  is  selected  if 
USE  fails. 

Summary  ranking  of  field  moisture  content  grouped  by 
'Material  Source'  with  a  total  ranking  for  all  sources. 

Summary  ranking  of  field  moisture  testing  using  only 
original  embankment  tests  (excluding  retest,  voids, 
instr.  pads)  by  report  period. 

Summary  ranking  of  field  dry  density  is  like  'SUMRMST' 
but  for  dry  density. 

Summary  ranking  of  field  compaction  testing  is  like 
SUMODEV  but  for  field  compaction  tests. 

Summary  ranking  of  field  moisture  content  ordered  by 
'Material  Source'  with  rankings  grouped  by  'Material 
Source'  with  totals  for  each  'Bnbankment  Zone.'  A 
record  is  selected  if  USE  fails. 

Summary  ranking  of  field  dry  density  ordered  by  'Mate¬ 
rial  Source'  with  rankings  grouped  by  'Material  Source' 
with  totals  for  each  'Embankment  Zone.'  A  record  is 
selected  if  USE  fails. 


(Continued) 
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Table  B1  (Concluded) 


Report  Writer 
File  Name 


De script ion 


SUMDEVR 

SUMCMPR 

SUMBDEV 

SUMBCMP 

SUMATTR 


Summary  ranking  of  deviation  from  optimum  water  content 
which  is  similar  to  SUMDEV  (which  selects  records  if  USE 
fails).  A  record  is  selected  if  REC  fails. 

Summary  ranking  of  percent  compaction,  similar  to 
SUMCMP  with  a  record  selected  if  REC  fails. 

Summary  ranking  of  deviation  from  optimum  water  content 
ordered  by  'Material  Source'  with  rankings  grouped  by 
'Material  Source'  and  totals  for  each  'Embankment  Zone.' 
A  record  is  selected  if  USE  fails. 

Summary  ranking  of  field  compaction  testing  ordered  by 
'Material  Source'  with  rankings  grouped  by  'Material 
Source'  and  totals  for  each  'Embankment  Zone. '  A 
record  is  selected  if  USE  fails. 

Summary  of  plasticity  testing  ordered  by  'Material 
Source,'  'Liquid  Limit,'  and  'Plastic  Index.'  This  file 
lists  'Material  Source,'  LL,  PI,  and  number  of  particu¬ 
lar  PI  that  exists.  A  record  is  selected  if  PI  exists. 


APPENDIX  C 


GRAPHIC  PROGRAM  INSTRUCTION  FILE,  GEOPLT 


OLD, GEOPIT 
OUST 

******  CORPS  OF  ENGINEERS  ****** 

******  GEOTECHNICAL  CONSTRUCTION  CONTROL  DATA  BASE  ****** 
******  GRAPHICS  PROGRAMS  ****** 


12  AUG  82 


QUICK-FINAL  WATER  CONTENTS  PLOT  PROCEDURE 


THIS  PROGRAM  WAS  DEVELOPED  FOR  A  132-CHARACTER  LINE  PRINTER, 
THEREFORE  THE  QUALITY  OF  THE  PLOTS  ON  ANY  OTHER  DEVICE  IS  UNCERTAIN 
AT  THIS  TIME. 

A.  BEFORE  THIS  GRAPHIC  PROGRAM  CAN  BE  USED, A  REPORT  FILE  MUST  BE 
GENERATED  FROM  THE  DATA  BASE.  THIS  FILE  CONTAINS  ONE  LINE  (70 
CHARACTERS)  OF  TITLE  INFORMATION  ( I .E. EMBANKMENT  ZONE. REPORT  NUMBER. 
BEGINNING  DATE, ENDING  DATE)  AND  THE  INFORMATION  FROM  THE  FOLLOWING 
COMMAND  THAT  IS  ISSUED  WHILE  THE  USER  IS  DOING  AD  HOC  RETRIEVALS  IN 
THE  DATA  BASE. 

1.  REPORT  FILE  IS  (FILENAME); 

2.  LIST  C21.CSS.C41.C43  WHERE  C21  EQ  (EMBANKMENT  ZONE)  AND 
CSS  EQ  (REPORT  NUMBER);  (TITLE  INFORMATION) 

3.  LIST  NO.OFWC.FUC.QIUC.WCI  WHERE  C21  EQ  (EMBANKMENT  ZONE) 
AND  CSS  EQ  (REPORT  NUMBER); 

4.  EXIT;  (EXIT  FROM  DATA  BASE) 

NOTE*  THE  DATA  COULD  BE  GROUPED  BY  REPORT  NUMBER. DATE. BORROW  SOURCE, 
LOCATION, OR  ANY  OTHER  VARIABLE  THAT  DEFINES  A  DATA  GROUP. 

THE  DATA  BASE  COMPONENTS  (NUMBERS  AND  ABBR. )  HAVE  THE  FOLLOWING 
MEANING: 

C21  -  EMBANKMENT  ZONE 

CSS  -  REPORT  NUMBER 

C41  -  BEGINNING  DATE  OF  REPORT  NUMBER 

C43  -  ENDING  DATE  OF  REPORT  NUMBER 

NO  -  TEST  NUMBER 

GFUC  -  QUICK  FIELD  WATER  CONTENT 

FUC  -  STANDARD  FIELD  WATER  CONTENT 

Q1WC  -  QUICK  ONE-POINT  WATER  CONTENT 

WC1  -  STANDARD  ONE-POINT  WATER  CONTENT 

B.  SET  THE  FORM-FEED  TO  TOP  OF  SHEET, HOLD  'CTRL'  KEY.PRESS'L' . 
TURN  PAPER  ADVANCE  KOLB  TO  FIRST  LINE  OF  NEW  SHEET.  THIS  NEEDS  TO 
BE  DONE  ONLY  ONCE  AT  THE  BEGINNING  OF  A  SESSION. 

C.  TO  EXCUTE  THIS  GRAPHIC  PROGRAM  THE  FOLLOWING  COMMANDS  ARE 
NEEDED: 


CET,QFW/UN>CER0K2 


BE  GENERATED  FROM  THE  DATA  BASE.  THIS  FILE  MUST  COHTAIH  THE  INFORMATION 
FROM  THE  FOLLOWING  COMMANDS  THAT  ARE  ISSUED  WHILE  THE  USER  IS 
DOING  AD  HOC  RETRIEVALS  IN  THE  DATA  BASE: 

1.  REPORT  FILE  IS  (FILE  NAME); 

2.  LIST  C1.C21  WHERE  C21  EQ  (EMBANKMENT  ZONE); 

3.  LIST  C23.C27.C29  WHERE  C21  EQ  (EMBANKMENT  ZONE); 

4.  LIST  CS5.C41.C43  WHERE  C21  EO  (EMBANKMENT  ZONE)  AND 
CSS  EQ  (REPORT  NUMBER): 

5.  LIST  C61.C63.C113, Clll. C149  WHERE  C21  EQ  (EMBANKMENT  ZONE) 
AND  CSS  EQ  (REPORT  NUMBER); 

6.  EXIT;  (EXIT  FROM  DATA  BASE) 

NOTE:  THE  DATA  COULD  BE  GROUPED  BV  REPORT  NUMBER . DATE . BORROW  SOURCE, 
LOCATION, OR  ANV  OTHER  UARIABLE  THAT  DEFINES  A  DATA  GROUP. 

THE  DATA  BASE  COMPONENT  NUMBERS  HAUE  THE  FOLLOWING  MEANINGS: 

Cl  -  PROJECT  NAME 

C21  -  EMBANKMENT  20NE 

C23  -  COMP-PERCENT 

C27  -  WATER  CONTENT  LIMITt LOWER) 

C29  -  WATER  CONTENT  LIMIT(UPPER) 

CSS  -  REPORT  NUMBER 

C41  -  BEGINNING  DATE  OF  REPORT  NUMBER 
C43  -  ENDING  DATE  OF  REPORT  NUMBER 
C61  -  TEST  NUMBER 

C63  -  INDICATOR  OF  THE  DESPOSITION  OF  THE  TEST 
Cl  13  -  PERCENT  COMPACTION 

Clll  -  DEUIATION  FROM  THE  OPTIUM  UATER  CONTENT 
Cl 49  -  COMMENTS  ABOUT  THE  TEST 

B.  SET  THE  FORM-FEED  AS  DESCRIBED  ABOVE. 

C.  TO  EXCUTE  THE  GRAPHIC  PROGRAM  THE  FOLLOWING  COMMANDS  ARE  NEEDED: 
GET.SG/UN*CER9K2 

CALL.SG 

THIS  SETS  THE  PLOT  PROCEDURE  IN  MOTION.  TWO  RESPONCES  ARE  REOUIRED  IN 
ANSWER  TO  THE  FOLLOWING  QUESTIONS: 

1.  DEVICE  -  (ENTER: PTR) 

2.  NAME  OF  DATA  FILE  (ENTER  REPORT  FILE  NAME) 


"CMEDIT"  TEXT  EDITOR  QUIK  REFERENCE  GUIDE 
COMMAND  FORMAT: 

COMMAND  (SHORTHAND)  :  DESCRIPTION. 

(SPACES  ARE  SIGNIFICANT) 

(WHERE  NUMBER  IS  SHOWN,  ANY  NUMBER  IS  OK.  IF  "l"  OR  "2",  IT 
NEED  NOT  BE  TYPED.) 

CMEDIT  (CME)  :  INVOKES  "CMEDIT",  E>  IS  DISPLAYED. 

QUIT  :  TO  QUIT  WITHOUT  USING  ANY  CHANGES. 

SAVE , O  :  TO  SAVE  ALL  CHANGES  THUS  FAR,  WITHOUT  LEAVING  EDITOR. 

I>  IS  DISPLAYED  FOR  AN  INSERT.  RETURN  CANCELS  THE 
INSERT  MODE  AND  RESTORES  E>. 

FILE, O  :  TO  SAVE  ALL  CHANGES  AND  TERMINATE  "CMEDIT" 

TOP  (T)  :  GO  TO  TOP  OF  FILE. 

BOTTOM  (B)  '  :  GO  TO  BOTTOM  OF  FILE. 

UP  5  (U  5)  :  GO  UP  5  LINES. 

DOWN  S  (D  5)  :  GO  DOWN  S  LINES. 

LINENO  :  WHAT  LINE  IS  THIS?  (CURRENT  LINE) 

GO  5  (G  5)  :  GO  TO  5-TH  LINE. 

PRINT  (P>  :  PRINT  CURRENT  LINE 

PRINT  5  (P  5)  :  PRINT  CURRENT  LINE  PLUS  NEXT  FOUR  LINES. 

INSERT  NEW  LINE  (I  NEW  LINE)  :  INSERT  LINE  CONTAINING  "NEW 

LINE"  AFTER  CURRENT  LINE. 

NEW  LINE  THEN  BECOMES  CURRENT 
LINE. 

INSERT  (INS)  :  INSERT  BLANK  LINE. 

DELETE  (DE)  :  DELETE  CURRENT  LINE.  NEXT  LINE 

BECOMES  CURRENT  LINE. 

REPLACE  NEW  LINE  (R  NEW  LINE)  :  REPLACE  CURRENT  LINE  WITH  "NEW 

LINE".  EQUIVALENT  OF  "DELETE", 

" UP " ,  AND  " I NSERT  NEW  LINE". 

LOCATE  /STRING/  (L  /STRING/)  5  GO  TO  NEXT  LINE  CONTAINING 


"STRING". 

LOCATE 

(L) 

:  REPEAT  PREVIOUS  "LOCATE" 

COMMAND. 

DITTO  5 

(DI  5) 

:  REPEAT  ANY  PREVIOUS  COMMAND 

5  TIMES. 

CHANGE  /STRING1 /STRING2/ 

(C  /STR I NG 1 / STR I NG2 / )  :  CHANGE  FIRST  OCCURRENCE  OF 

"STRINGl "  TO  "STRING2"  ON 
CURRENT  LINE. 

CHANGE  (C>  :  REPEAT  PREVIOUS  "CHANGE" 

COMMAND. 

CHANGE  /STRINGl /STRING2/  *  *  :  CHANGE  "STRINGl"  TO  "STRING2" 


L INEND 

(LI) 

FOR  ALL  OCCURRENCES  ON  ALL 

LINES. 

:  USE  BEFORE  ENTERING  "5"  CHARACTER,  TO 

START 

(ST) 

CLFAR  SPECIAL  "CMEDIT"  INTERPRETATION 

OF 

:  DEFINE  START  OF  BLOCK  FOR  LATER  COMMAND. 

END 

REMOVE 

MOVE 

:  DEFINE  END  OF  BLOCK  FOR  LATER  COMMAND. 

:  DELETES  DEFINED  BLOCK. 

:  INSERTS  DEFINED  BLOCK  AFTER  CURRENT  LINE. 

FOR  FURTHER  "CMEDIT"  DOCUMENTATION,  GET  THE  BOEING  COMPUTER 
SERVICES  (BCS)  MANUAL  10208-005,  "INTERACTIVE  TIMESHAR¬ 
ING  (KIT)  USERS  MANUAL. 
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INSTRUCTIONS  FOR  BACKUP  OF  DATA  BASE  IN  CASE  OF  DAMAGE 
DURING  ADDING  OR  MODIFYING  DATA 

C>  -S2000,  SR 
SAVE  OR  RESTORED? 

I>  SAVE 

NAME  OF  THE  DATA  BASE  TO  BE  SAVED/RESTORED? 

I>  "DATA  BASE  NAME" 

NAME  OF  FILE  THAT  DATA  BASE  IS  SAVED/ 

RESTORED  ON?  (DEFAULT  IS  TAPE999) 

I>  "SAVE  FILE  NAME" 

83/03/22.  11.54.14.  BEGIN  SYSTEM  2000  VERSION  2-60F 

I  USER,  . . . 


NOTE:  ONCE  THE  SAVE  FILE  IS  NO  LONGER  NEEDED,  YOU  MUST  PURGE  IT 
TO  AVOID  UNNECESSARY  STORAGE  COST. 
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In  accordance  with  letter  from  DAEN-RDC,  DAEN-ASI  dated 
22  July  1977,  Subject:  Facsimile  Catalog  Cards  for 
Laboratory  Technical  Publications,  a  facsimile  catalog 
card  in  Library  of  Congress  MARC  format  is  reproduced 
below. 


Edris,  Earl  V. 

Geotechnical  construction  control  data  base  system: 
user's  manual  /  by  Earl  V.  Edris,  Jr.,  David  P.  Hammer, 
Wipawi  Vanadit-El lis  (Geotechnical  Laboratory,  U.S. 

Army  Engineer  Waterways  Experiment  Station).  -- 
Vicksburg,  Miss.  :  The  Station  ;  Springfield,  Va.  ; 
available  from  NTIS,  1983. 

185  p.  in  various  pagings  :  ill.  ;  27  cm.  -- 
(Instruction  report  ;  GL-83-1) 

Cover  title. 

"April  1983." 

Final  report. 

"Prepared  for  Office,  Chief  of  Engineers,  U.S.  Army." 

"A  report  under  the  Computer  Applications  in  Geo¬ 
technical  Engineering  (CAGE)  Project." 

Bibliography:  p.  165. 


Edris,  Earl  V. 

Geotechnical  construction  control  data  base  :  ...  1983. 

(Card  2) 

1.  Earth  dams.  2.  Electronic  data  processing. 

3.  Engineering.  I.  Hammer,  David  P.  II.  Vanadit- 
Ellis,  Wipawi.  III.  United  States.  Army.  Corps  of 
Engineers.  Office  of  the  Chief  of  Engineers.  IV.  U.S. 

Army  Engineer  Waterways  Experiment  Station.  Geotechni¬ 
cal  Laboratory.  V.  Title  VI.  Series:  Instruction 
report  (U.S.  Army  Engineer  Waterways  Experiment  Station) 
GL-83-1 . 


